エラーと可観測性

ワイヤエラーは安定したプロトコルの結果であり、内部例外のダンプではありません。エラーはローカルエラースキーマに準拠し、再試行が安全かどうかを示し、未承認のデータを公開することなく関連フレームまたはアクション ID を識別できます (MWP-EXT-004)。

正しいレイヤーで分類する

レイヤー	公開結果
無効な JSON、重複メンバー、または不可能な JCS 値	`PROTOCOL_VIOLATION`
完全なスキーマまたは必須エンベロープの失敗	`SCHEMA_VALIDATION_FAILED`
暗号ステージ 3、4、または 6 の失敗	`AUTH_INVALID_SIGNATURE`
アドミッションまたは Command 鮮度の失敗	`AUTH_INVALID_SIGNATURE`
権限またはポリシーの資格がありません	`AUTH_FORBIDDEN`
古いセッション、Membership、Coordinator、所有権、またはリース状態	対応する安定したフェンシングコード
現在の集計リビジョンの不一致	`REVISION_CONFLICT`
許容圧力限界	`BACKPRESSURE` または `RATE_LIMITED` (再試行ガイダンスあり)

暗号およびアドミッションの失敗は、ネットワーク上で意図的に崩壊します。 Organization は、最初に失敗したセマンティックステージと特定の理由を、保護されアクセス制御された監査レコードにのみ保持します (MWP-SDV-018)。ステージ番号は、必要な内部関数境界ではなく、意味論的な分類です (MWP-SDV-016)。アドミッションパスの 6 ステージ完了後のすべての失敗では、保護されたステージ admission と同じパブリックコード AUTH_INVALID_SIGNATURE (MWP-ADM-012) が使用されます。

決定を再試行する

再試行の動作は、安定したコードと、保護されたコンテンツが有効なままであるかどうかによって異なります。

変更せずに受け入れられた Command 再試行では、元のアクション ID と署名が保持されます。内容。
AUTH_INVALID_SIGNATURE は、原因が判明するまで変更せずに再試行されません。修正しました。
有効期限が切れた Command の鮮度には、新しい Command、アクション ID、保護された時間が必要です。そして署名。
ACTION_ID_COLLISION には常に新しいアクション ID と署名されたコンテンツが必要です。そして
古いフェンシングエラーには、現在の権威あるエポックに加えて新しい Command が必要ですそしてサイン。

完全なルールは MWP-EXT-005) です。信頼できる応答がない場合のトランスポートタイムアウトは不定です。新しい遷移を送信するかどうかを決定する前に、安定した ID によってクエリまたはリプレイが行われます。

保護された監査レコード

Organization は、MWP-SDV-018 の要求に従って、最初に失敗したセマンティックステージとその特定の理由を、保護されアクセス制御された監査レコードに保持します。

シークレット、機能トークン、秘密鍵マテリアル、未加工の認証情報、未承認のものを入れないでください。 Group 存在、または保護された信頼と失敗の区別をワイヤ応答に含めます。トークンと認証情報はメッセージから除外されます。 Agent カード、コンテキストパッケージ、アーティファクト、イベントも同様に (MWP-AUT-002)。

監査証拠は、プライベートな思考連鎖、隠されたプロンプト、生の内部メモリを必要とせずに、意思決定、入力、阻害要因、および結果をカバーします (MWP-FND-022)。

リビジョンに依存する障害

代替署名バイトの動作を互換性回復パスとして扱わないでください。署名エンベロープの別の部分を保護するリビジョンは、ワイヤー署名バイトを変更するため、v0.1 として生成したりサイレントに受け入れたりすることはできません (MWP-SDV-019)。

シリアル化コードが内部原因を誤って公開しないように、公開エラータイプと保護診断タイプを別々に使用してください。ログとトレースは、完全なプロトコル文書を埋め込むのではなく、安定した ID とハッシュを参照する必要があります。

認可された監査人にとって、有用な構造化フィールドには次のものがあります。

最初に失敗したセマンティックステージ、安定した内部理由、およびソースアダプター。
正確なリリース、スキーマ、プロファイル、実装バージョン。
承認された Organization、Group、アクター、アクション ID、相関 ID、および署名ハッシュ参照。
関連する Registry リビジョンまたは Admission Log 結果の ID。そして
権威ある状態が変化したかどうか。

コマンドはすでに安定したアクションと相関 ID (MWP-EVT-001) を保持しており、受け入れられたイベントは不変の原因、アクター、相関、シーケンス、リビジョンコンテキスト (MWP-EVT-005) を保持します。無関係なトレース ID への参照を優先します。

有用なメトリクスには、パブリックコードによる受け入れおよび拒否されたコマンド、制限付きテレメトリで最初に失敗した保護ステージ、Group によるリプレイラグ、カーソルギャップカウント、重複 Event カウント、リースおよびバジェットの拒否カウント、バックプレッシャー期間、アドミッションアダプターの結果、およびエンドツーエンドの移行レイテンシが含まれます。 Organization、Group、アクター、アクション、キー、または署名ハッシュ識別子をアタッチする前に、有界カーディナリティを定義します。

リリースのサポートを申請する前に、適合性とアップグレードを完了してください。