@dp-bohrium/widget-cli 0.5.0 → 0.6.0

package/assets/schemas/widget-runtime-contracts.schema.json

@@ -119,6 +119,28 @@
     },
     "hostUserServiceRequest": {
       "$ref": "#/$defs/HostUserServiceRequest"
+    },
+    "widgetDevelopmentDiagnostic": {
+      "$ref": "#/$defs/WidgetDevelopmentDiagnostic"
+    },
+    "widgetRecoveryContext": { "$ref": "#/$defs/WidgetRecoveryContext" },
+    "widgetRecoveryPlan": {
+      "$ref": "#/$defs/WidgetRecoveryPlan"
+    },
+    "widgetRecoveryRule": {
+      "$ref": "#/$defs/WidgetRecoveryRule"
+    },
+    "widgetDevelopmentOffer": {
+      "$ref": "#/$defs/WidgetDevelopmentOffer"
+    },
+    "widgetDevelopmentConnect": {
+      "$ref": "#/$defs/WidgetDevelopmentConnect"
+    },
+    "widgetRenderResult": {
+      "$ref": "#/$defs/WidgetRenderResult"
+    },
+    "widgetDevelopmentMessage": {
+      "$ref": "#/$defs/WidgetDevelopmentMessage"
     }
   },
   "$defs": {
@@ -2869,6 +2891,890 @@
           ]
         }
       }
+    },
+    "WidgetDiagnosticDetail": {
+      "title": "WidgetDiagnosticDetail",
+      "description": "受控字段诊断或工程相对源码位置；不携带原始对象。",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "field"
+          ],
+          "properties": {
+            "field": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128
+            },
+            "expected": {
+              "type": "string",
+              "maxLength": 256
+            },
+            "observed": {
+              "type": "string",
+              "maxLength": 256
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "file",
+            "line",
+            "column"
+          ],
+          "properties": {
+            "file": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256,
+              "pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*(?:^|/)\\.{1,2}(?:/|$))[^\\u0000-\\u001f]+$"
+            },
+            "line": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "column": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "excerpt": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024
+            }
+          }
+        }
+      ]
+    },
+    "WidgetDiagnosticIO": {
+      "title": "WidgetDiagnosticIO",
+      "description": "保留 transport、HTTP 与非法响应事实；不包含 URL 或原始响应。",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "transport",
+                "invalid-response"
+              ]
+            },
+            "sourceCode": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 96,
+              "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "status"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "http"
+              ]
+            },
+            "status": {
+              "type": "integer",
+              "minimum": 100,
+              "maximum": 599,
+              "not": { "minimum": 200, "maximum": 299 }
+            },
+            "sourceCode": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 96,
+              "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+            }
+          }
+        }
+      ]
+    },
+    "WidgetDevelopmentDiagnostic": {
+      "title": "WidgetDevelopmentDiagnostic",
+      "description": "可信出口的标准诊断；恢复指令和 scope 由宿主另行生成。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "source",
+        "code",
+        "phase",
+        "operation",
+        "severity",
+        "message"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "source": {
+          "enum": [
+            "sdk",
+            "host",
+            "toolchain"
+          ]
+        },
+        "code": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "sourceCode": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "phase": {
+          "enum": [
+            "discovery",
+            "build",
+            "config",
+            "load",
+            "handshake",
+            "render",
+            "update",
+            "capability",
+            "dispose"
+          ]
+        },
+        "sourcePhase": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "operation": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "severity": {
+          "enum": [
+            "warning",
+            "request-error",
+            "instance-failure"
+          ]
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "correlationId": { "$ref": "#/$defs/WidgetError/properties/correlationId" },
+        "diagnostics": {
+          "type": "array",
+          "maxItems": 8,
+          "items": {
+            "$ref": "#/$defs/WidgetDiagnosticDetail"
+          }
+        },
+        "io": {
+          "$ref": "#/$defs/WidgetDiagnosticIO"
+        }
+      }
+    },
+    "WidgetRecoveryAction": {
+      "title": "WidgetRecoveryAction",
+      "description": "恢复动作的语义及类型化参数；可信宿主绑定已有工具，不包含任意命令。",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "inspect"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "area"
+              ],
+              "properties": {
+                "area": {
+                  "enum": [
+                    "toolchain",
+                    "host-bridge",
+                    "configuration",
+                    "bundle",
+                    "handshake",
+                    "render",
+                    "capability",
+                    "lease",
+                    "operation-outcome",
+                    "runtime"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "wait"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "milestone"
+              ],
+              "properties": {
+                "milestone": {
+                  "enum": [
+                    "budget-reset",
+                    "connection-restored"
+                  ]
+                },
+                "retryAfterMs": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "edit-project"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "evidence"
+              ],
+              "properties": {
+                "evidence": {
+                  "const": "diagnostics"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "build-project"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "target"
+              ],
+              "properties": {
+                "target": {
+                  "const": "current-project"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "refresh-preview"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "target"
+              ],
+              "properties": {
+                "target": {
+                  "const": "current-project"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "verify-scenario"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "target"
+              ],
+              "properties": {
+                "target": {
+                  "enum": [
+                    "current-attempt",
+                    "next-built-generation"
+                  ]
+                },
+                "scenarioId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 96,
+                  "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "request-external-action"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "reason"
+              ],
+              "properties": {
+                "reason": {
+                  "enum": [
+                    "authorization",
+                    "host-support",
+                    "host-start",
+                    "credentials"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "stop-preview"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "target"
+              ],
+              "properties": {
+                "target": {
+                  "const": "current-preview"
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "WidgetRecoveryVerification": {
+      "title": "WidgetRecoveryVerification",
+      "description": "恢复复验目标；下一成功构建须在取得回执后绑定实际产物。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "milestone"
+      ],
+      "properties": {
+        "target": {
+          "enum": [
+            "current-attempt",
+            "next-built-generation",
+            "original-operation"
+          ]
+        },
+        "milestone": {
+          "enum": [
+            "diagnostics-updated",
+            "render-handled",
+            "scenario-passed",
+            "operation-confirmed"
+          ]
+        },
+        "scenarioId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        }
+      }
+    },
+    "WidgetRecoveryPlan": {
+      "title": "WidgetRecoveryPlan",
+      "description": "可信宿主选择的恢复计划；不能由 Guest 的诊断 payload 指定。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "ruleId",
+        "ruleVersion",
+        "disposition",
+        "nextAction",
+        "verification",
+        "guidance",
+        "followUpActions"
+      ],
+      "properties": {
+        "progress": { "$ref": "#/$defs/WidgetRecoveryProgress" },
+        "schemaVersion": {
+          "const": 1
+        },
+        "ruleId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "ruleVersion": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "disposition": {
+          "enum": [
+            "retry",
+            "repair",
+            "inspect",
+            "external-action",
+            "stop"
+          ]
+        },
+        "nextAction": {
+          "$ref": "#/$defs/WidgetRecoveryAction"
+        },
+        "verification": {
+          "$ref": "#/$defs/WidgetRecoveryVerification"
+        },
+        "guidance": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "followUpActions": {
+          "description": "首项动作完成后的有限恢复步骤；宿主逐步验证前置条件，不原样盲目重放。",
+          "type": "array",
+          "maxItems": 8,
+          "items": {
+            "$ref": "#/$defs/WidgetRecoveryAction"
+          }
+        }
+      }
+    },
+    "WidgetRecoveryRule": {
+      "title": "WidgetRecoveryRule",
+      "description": "公共恢复规则目录条目；空 codes 仅用于显式 unknown 回退。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "sources",
+        "codes",
+        "disposition",
+        "nextAction",
+        "verification",
+        "guidance",
+        "followUpActions"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "version": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 3,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "sdk",
+              "host",
+              "toolchain"
+            ]
+          }
+        },
+        "codes": {
+          "type": "array",
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 96,
+            "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+          }
+        },
+        "disposition": {
+          "enum": [
+            "retry",
+            "repair",
+            "inspect",
+            "external-action",
+            "stop"
+          ]
+        },
+        "nextAction": {
+          "$ref": "#/$defs/WidgetRecoveryAction"
+        },
+        "verification": {
+          "$ref": "#/$defs/WidgetRecoveryVerification"
+        },
+        "guidance": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "followUpActions": {
+          "description": "首项动作完成后的有限恢复步骤；宿主逐步验证前置条件，不原样盲目重放。",
+          "type": "array",
+          "maxItems": 8,
+          "items": {
+            "$ref": "#/$defs/WidgetRecoveryAction"
+          }
+        }
+      }
+    },
+    "WidgetDevelopmentExtension": {
+      "title": "WidgetDevelopmentExtension",
+      "description": "经 offer/connect 显式选择的开发扩展；不授予 capability。",
+      "const": "development-diagnostics-v1"
+    },
+    "WidgetDevelopmentOffer": {
+      "title": "WidgetDevelopmentOffer",
+      "description": "独立于旧 bootstrap-ready 的支持声明，接收方仍须校验 frame 来源和挂载尝试。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "protocolVersion",
+        "extensions"
+      ],
+      "properties": {
+        "type": {
+          "const": "widget-bootstrap-offer"
+        },
+        "protocolVersion": {
+          "const": 1
+        },
+        "extensions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/WidgetDevelopmentExtension"
+          }
+        }
+      }
+    },
+    "WidgetDevelopmentConnect": {
+      "title": "WidgetDevelopmentConnect",
+      "description": "仅在收到当前 iframe 合法 offer 后使用的扩展 connect；旧形状保持不变。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "protocolVersion",
+        "channelId",
+        "initPayload",
+        "extensions"
+      ],
+      "properties": {
+        "type": {
+          "const": "widget-host-connect"
+        },
+        "protocolVersion": {
+          "const": 1
+        },
+        "channelId": {
+          "type": "string",
+          "minLength": 16
+        },
+        "initPayload": {
+          "$ref": "#/$defs/InitPayload"
+        },
+        "extensions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/WidgetDevelopmentExtension"
+          }
+        }
+      }
+    },
+    "WidgetRenderResult": {
+      "title": "WidgetRenderResult",
+      "description": "仅表示受管渲染处理器的处理结果，不代表视觉或业务验收。",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "requestId",
+            "revision",
+            "outcome"
+          ],
+          "properties": {
+            "requestId": { "$ref": "#/$defs/RenderRequestBase/properties/requestId" },
+            "revision": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "outcome": {
+              "enum": [
+                "handled",
+                "superseded"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "requestId",
+            "revision",
+            "outcome",
+            "diagnostic"
+          ],
+          "properties": {
+            "requestId": { "$ref": "#/$defs/RenderRequestBase/properties/requestId" },
+            "revision": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "outcome": {
+              "const": "failed"
+            },
+            "diagnostic": {
+              "$ref": "#/$defs/WidgetRenderFailureDiagnostic"
+            }
+          }
+        }
+      ]
+    },
+    "WidgetDiagnosticMessage": {
+      "title": "WidgetDiagnosticMessage",
+      "description": "经协商的开发扩展 Bridge 消息；仍受现有通道与消息预算约束。",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/BridgeEnvelopeBase"
+        },
+        {
+          "type": "object",
+          "required": [
+            "type",
+            "payload"
+          ],
+          "properties": {
+            "type": {
+              "const": "diagnostic"
+            },
+            "payload": {
+              "$ref": "#/$defs/WidgetGuestDiagnostic"
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "WidgetRenderResultMessage": {
+      "title": "WidgetRenderResultMessage",
+      "description": "经协商的开发扩展 Bridge 消息；仍受现有通道与消息预算约束。",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/BridgeEnvelopeBase"
+        },
+        {
+          "type": "object",
+          "required": [
+            "type",
+            "payload"
+          ],
+          "properties": {
+            "type": {
+              "const": "render-result"
+            },
+            "payload": {
+              "$ref": "#/$defs/WidgetRenderResult"
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "WidgetDevelopmentMessage": {
+      "title": "WidgetDevelopmentMessage",
+      "description": "扩展 profile 下的 Widget → Host 消息；原 WidgetToHostMessage 不扩展。",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/WidgetToHostMessage"
+        },
+        {
+          "$ref": "#/$defs/WidgetDiagnosticMessage"
+        },
+        {
+          "$ref": "#/$defs/WidgetRenderResultMessage"
+        }
+      ]
+    },
+    "WidgetRecoveryContext": {
+      "title": "WidgetRecoveryContext",
+      "description": "复用工具执行结果语义的可信恢复上下文；缺失字段表示未知，不能授权重放。",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "progress": { "$ref": "#/$defs/WidgetRecoveryProgress" },
+        "executionState": {
+          "enum": [
+            "not_started",
+            "finished",
+            "partial",
+            "unknown"
+          ]
+        },
+        "mayHaveExecuted": {
+          "type": "boolean"
+        }
+      }
+    },
+    "WidgetGuestDiagnostic": {
+      "title": "WidgetGuestDiagnostic",
+      "description": "Guest 仅声明 SDK 诊断事实，不得冒充 Host 或工具链。",
+      "allOf": [
+        {
+          "$ref": "#/$defs/WidgetDevelopmentDiagnostic"
+        },
+        {
+          "type": "object",
+          "required": [
+            "source"
+          ],
+          "properties": {
+            "source": {
+              "const": "sdk"
+            }
+          }
+        }
+      ]
+    },
+    "WidgetRenderFailureDiagnostic": {
+      "title": "WidgetRenderFailureDiagnostic",
+      "description": "失败处理回执的 SDK 请求诊断；接收方还须匹配当前 requestId。",
+      "allOf": [
+        {
+          "$ref": "#/$defs/WidgetGuestDiagnostic"
+        },
+        {
+          "type": "object",
+          "required": [
+            "correlationId"
+          ],
+          "properties": {
+            "correlationId": { "$ref": "#/$defs/WidgetDevelopmentDiagnostic/properties/correlationId" },
+            "phase": {
+              "enum": [
+                "render",
+                "update"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "WidgetRecoveryProgress": {
+      "title": "WidgetRecoveryProgress",
+      "description": "可信宿主观察到的恢复进展；重复故障无新证据时不能重复同一修复。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "repeated",
+        "hasNewEvidence"
+      ],
+      "properties": {
+        "repeated": {
+          "type": "boolean"
+        },
+        "hasNewEvidence": {
+          "type": "boolean"
+        }
+      }
     }
   }
 }