{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/fiasignals-com/json-schema/fiasignals-com-a2-aaudit-report-schema.json",
  "title": "A2AAuditReport",
  "x-generated": "2026-11-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/fiasignals-com-openapi.json#/components/schemas/A2AAuditReport",
  "properties": {
    "schema_version": {
      "type": "string",
      "title": "Schema Version",
      "default": "1.0.0"
    },
    "audit_type": {
      "type": "string",
      "enum": [
        "tier_1_launch_check",
        "tier_2_integration_audit"
      ],
      "title": "Audit Type"
    },
    "target_name": {
      "type": "string",
      "title": "Target Name"
    },
    "executive_summary": {
      "$ref": "#/$defs/A2AAuditExecutiveSummary"
    },
    "overall_readiness": {
      "type": "string",
      "enum": [
        "ready",
        "needs_fixes",
        "blocked"
      ],
      "title": "Overall Readiness"
    },
    "deployment_risk": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "critical"
      ],
      "title": "Deployment Risk"
    },
    "go_live_recommendation": {
      "type": "string",
      "enum": [
        "go_live",
        "fix_before_launch",
        "hold_launch"
      ],
      "title": "Go Live Recommendation"
    },
    "launch_readiness": {
      "type": "string",
      "enum": [
        "safe",
        "caution",
        "unsafe",
        "unknown"
      ],
      "title": "Launch Readiness"
    },
    "scale_readiness": {
      "type": "string",
      "enum": [
        "safe",
        "caution",
        "unsafe",
        "unknown"
      ],
      "title": "Scale Readiness"
    },
    "premium_sale_readiness": {
      "type": "string",
      "enum": [
        "safe",
        "caution",
        "unsafe",
        "unknown"
      ],
      "title": "Premium Sale Readiness"
    },
    "evidence_sufficiency": {
      "type": "string",
      "enum": [
        "strong",
        "partial",
        "weak",
        "insufficient"
      ],
      "title": "Evidence Sufficiency"
    },
    "evidence_confidence": {
      "type": "number",
      "maximum": 1.0,
      "minimum": 0.0,
      "title": "Evidence Confidence"
    },
    "surface_summary": {
      "$ref": "#/$defs/A2AAuditSurfaceSummary"
    },
    "lifecycle": {
      "items": {
        "$ref": "#/$defs/A2AAuditLifecycleStage"
      },
      "type": "array",
      "title": "Lifecycle"
    },
    "wallet_truth": {
      "$ref": "#/$defs/A2AAuditWalletTruthSummary"
    },
    "blocker_groups": {
      "items": {
        "$ref": "#/$defs/A2AAuditBlockerGroup"
      },
      "type": "array",
      "title": "Blocker Groups"
    },
    "findings": {
      "items": {
        "$ref": "#/$defs/A2AAuditFinding"
      },
      "type": "array",
      "title": "Findings"
    },
    "ranked_fix_list": {
      "items": {
        "$ref": "#/$defs/A2AAuditFixItem"
      },
      "type": "array",
      "title": "Ranked Fix List"
    },
    "minimum_required_fixes": {
      "items": {
        "$ref": "#/$defs/A2AAuditFixItem"
      },
      "type": "array",
      "title": "Minimum Required Fixes"
    },
    "safe_to_ignore_for_now": {
      "items": {
        "$ref": "#/$defs/A2AAuditFixItem"
      },
      "type": "array",
      "title": "Safe To Ignore For Now"
    },
    "critical_unknowns": {
      "items": {
        "$ref": "#/$defs/A2AAuditCriticalUnknown"
      },
      "type": "array",
      "title": "Critical Unknowns"
    },
    "integration_seams": {
      "items": {
        "$ref": "#/$defs/A2AAuditIntegrationSeam"
      },
      "type": "array",
      "title": "Integration Seams"
    },
    "final_recommendation": {
      "type": "string",
      "title": "Final Recommendation"
    },
    "warnings": {
      "items": {
        "$ref": "#/$defs/A2AAuditWarning"
      },
      "type": "array",
      "title": "Warnings"
    },
    "limitations": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Limitations"
    },
    "implemented_check_buckets": {
      "items": {
        "type": "string",
        "enum": [
          "schema_interface",
          "metadata_parity",
          "routing_payment_provider",
          "handshake_delivery",
          "observability_auditability",
          "lifecycle_execution",
          "wallet_truth"
        ]
      },
      "type": "array",
      "title": "Implemented Check Buckets"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "title": "Timestamp"
    },
    "ttl_seconds": {
      "type": "integer",
      "minimum": 60.0,
      "title": "Ttl Seconds",
      "default": 3600
    }
  },
  "type": "object",
  "required": [
    "audit_type",
    "target_name",
    "executive_summary",
    "overall_readiness",
    "deployment_risk",
    "go_live_recommendation",
    "launch_readiness",
    "scale_readiness",
    "premium_sale_readiness",
    "evidence_sufficiency",
    "evidence_confidence",
    "surface_summary",
    "final_recommendation"
  ],
  "$defs": {
    "A2AAuditBlockerGroup": {
      "properties": {
        "blocker_class": {
          "type": "string",
          "enum": [
            "launch_blocker",
            "scale_blocker",
            "premium_sale_blocker",
            "advisory"
          ],
          "title": "Blocker Class"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "summary": {
          "type": "string",
          "title": "Summary"
        },
        "finding_codes": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Finding Codes"
        }
      },
      "type": "object",
      "required": [
        "blocker_class",
        "title",
        "summary"
      ],
      "title": "A2AAuditBlockerGroup"
    },
    "A2AAuditCriticalUnknown": {
      "properties": {
        "code": {
          "type": "string",
          "title": "Code"
        },
        "question": {
          "type": "string",
          "title": "Question"
        },
        "why_it_matters": {
          "type": "string",
          "title": "Why It Matters"
        },
        "blocker_class": {
          "type": "string",
          "enum": [
            "launch_blocker",
            "scale_blocker",
            "premium_sale_blocker",
            "advisory"
          ],
          "title": "Blocker Class"
        },
        "required_seams": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Required Seams"
        }
      },
      "type": "object",
      "required": [
        "code",
        "question",
        "why_it_matters",
        "blocker_class"
      ],
      "title": "A2AAuditCriticalUnknown"
    },
    "A2AAuditEvidenceSource": {
      "properties": {
        "surface": {
          "type": "string",
          "enum": [
            "local",
            "public",
            "runtime",
            "dispatch",
            "wallet_truth",
            "delivery_guarantee",
            "probe"
          ],
          "title": "Surface"
        },
        "status": {
          "type": "string",
          "enum": [
            "available",
            "partial",
            "missing",
            "error"
          ],
          "title": "Status"
        },
        "source_type": {
          "type": "string",
          "enum": [
            "inline",
            "file",
            "url",
            "probe",
            "adapter",
            "missing"
          ],
          "title": "Source Type"
        },
        "reference": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reference"
        },
        "adapter_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Adapter Name"
        },
        "truth_strength": {
          "type": "string",
          "enum": [
            "strong",
            "moderate",
            "weak",
            "none"
          ],
          "title": "Truth Strength",
          "default": "none"
        },
        "collected_fields": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Collected Fields"
        },
        "warnings": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Warnings"
        },
        "latency_ms": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Latency Ms"
        },
        "limitation": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Limitation"
        }
      },
      "type": "object",
      "required": [
        "surface",
        "status",
        "source_type"
      ],
      "title": "A2AAuditEvidenceSource"
    },
    "A2AAuditExecutiveSummary": {
      "properties": {
        "headline": {
          "type": "string",
          "title": "Headline"
        },
        "launch_readiness": {
          "type": "string",
          "enum": [
            "safe",
            "caution",
            "unsafe",
            "unknown"
          ],
          "title": "Launch Readiness"
        },
        "scale_readiness": {
          "type": "string",
          "enum": [
            "safe",
            "caution",
            "unsafe",
            "unknown"
          ],
          "title": "Scale Readiness"
        },
        "premium_sale_readiness": {
          "type": "string",
          "enum": [
            "safe",
            "caution",
            "unsafe",
            "unknown"
          ],
          "title": "Premium Sale Readiness"
        },
        "evidence_sufficiency": {
          "type": "string",
          "enum": [
            "strong",
            "partial",
            "weak",
            "insufficient"
          ],
          "title": "Evidence Sufficiency"
        },
        "evidence_confidence": {
          "type": "number",
          "maximum": 1.0,
          "minimum": 0.0,
          "title": "Evidence Confidence"
        },
        "operator_takeaway": {
          "type": "string",
          "title": "Operator Takeaway"
        }
      },
      "type": "object",
      "required": [
        "headline",
        "launch_readiness",
        "scale_readiness",
        "premium_sale_readiness",
        "evidence_sufficiency",
        "evidence_confidence",
        "operator_takeaway"
      ],
      "title": "A2AAuditExecutiveSummary"
    },
    "A2AAuditFinding": {
      "properties": {
        "code": {
          "type": "string",
          "title": "Code"
        },
        "category": {
          "type": "string",
          "enum": [
            "schema_interface",
            "metadata_parity",
            "routing_payment_provider",
            "handshake_delivery",
            "observability_auditability",
            "lifecycle_execution",
            "wallet_truth"
          ],
          "title": "Category"
        },
        "severity": {
          "type": "string",
          "enum": [
            "critical",
            "high",
            "medium",
            "low"
          ],
          "title": "Severity"
        },
        "blocker_class": {
          "type": "string",
          "enum": [
            "launch_blocker",
            "scale_blocker",
            "premium_sale_blocker",
            "advisory"
          ],
          "title": "Blocker Class"
        },
        "confidence": {
          "type": "number",
          "maximum": 1.0,
          "minimum": 0.0,
          "title": "Confidence"
        },
        "evidence_strength": {
          "type": "string",
          "enum": [
            "strong",
            "moderate",
            "weak",
            "none"
          ],
          "title": "Evidence Strength",
          "default": "weak"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "summary": {
          "type": "string",
          "title": "Summary"
        },
        "evidence": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Evidence"
        },
        "affected_surfaces": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Affected Surfaces"
        },
        "recommended_fix": {
          "type": "string",
          "title": "Recommended Fix"
        }
      },
      "type": "object",
      "required": [
        "code",
        "category",
        "severity",
        "blocker_class",
        "confidence",
        "title",
        "summary",
        "recommended_fix"
      ],
      "title": "A2AAuditFinding"
    },
    "A2AAuditFixItem": {
      "properties": {
        "rank": {
          "type": "integer",
          "minimum": 1.0,
          "title": "Rank"
        },
        "priority": {
          "type": "string",
          "enum": [
            "critical",
            "high",
            "medium",
            "low"
          ],
          "title": "Priority"
        },
        "blocker_class": {
          "type": "string",
          "enum": [
            "launch_blocker",
            "scale_blocker",
            "premium_sale_blocker",
            "advisory"
          ],
          "title": "Blocker Class"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "rationale": {
          "type": "string",
          "title": "Rationale"
        },
        "action": {
          "type": "string",
          "title": "Action"
        },
        "source_finding_codes": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Source Finding Codes"
        }
      },
      "type": "object",
      "required": [
        "rank",
        "priority",
        "blocker_class",
        "title",
        "rationale",
        "action"
      ],
      "title": "A2AAuditFixItem"
    },
    "A2AAuditIntegrationSeam": {
      "properties": {
        "seam": {
          "type": "string",
          "title": "Seam"
        },
        "status": {
          "type": "string",
          "enum": [
            "live_ready",
            "scaffolded",
            "missing"
          ],
          "title": "Status"
        },
        "current_adapter": {
          "type": "string",
          "title": "Current Adapter"
        },
        "purpose": {
          "type": "string",
          "title": "Purpose"
        },
        "required_for": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Required For"
        },
        "minimum_contract_fields": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Minimum Contract Fields"
        },
        "notes": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Notes"
        }
      },
      "type": "object",
      "required": [
        "seam",
        "status",
        "current_adapter",
        "purpose"
      ],
      "title": "A2AAuditIntegrationSeam"
    },
    "A2AAuditLifecycleStage": {
      "properties": {
        "stage": {
          "type": "string",
          "enum": [
            "listing_discovery",
            "route_parity",
            "endpoint_reachability",
            "request_shape_acceptance",
            "dispatch_acceptance",
            "runtime_acknowledgement",
            "delivery_attempt",
            "delivery_completion",
            "payment_settlement",
            "evaluator_completion",
            "observability_retention"
          ],
          "title": "Stage"
        },
        "state": {
          "type": "string",
          "enum": [
            "passed",
            "partial",
            "failed",
            "missing",
            "timed_out",
            "unknown",
            "not_applicable"
          ],
          "title": "State"
        },
        "evidence_strength": {
          "type": "string",
          "enum": [
            "strong",
            "moderate",
            "weak",
            "none"
          ],
          "title": "Evidence Strength",
          "default": "none"
        },
        "blocker_class": {
          "type": "string",
          "enum": [
            "launch_blocker",
            "scale_blocker",
            "premium_sale_blocker",
            "advisory"
          ],
          "title": "Blocker Class",
          "default": "advisory"
        },
        "summary": {
          "type": "string",
          "title": "Summary"
        },
        "evidence_sources": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Evidence Sources"
        },
        "notes": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Notes"
        }
      },
      "type": "object",
      "required": [
        "stage",
        "state",
        "summary"
      ],
      "title": "A2AAuditLifecycleStage"
    },
    "A2AAuditSurfaceStatus": {
      "properties": {
        "surface": {
          "type": "string",
          "enum": [
            "local",
            "public",
            "runtime",
            "dispatch",
            "wallet_truth",
            "delivery_guarantee"
          ],
          "title": "Surface"
        },
        "status": {
          "type": "string",
          "enum": [
            "available",
            "partial",
            "missing",
            "error"
          ],
          "title": "Status"
        },
        "truth_strength": {
          "type": "string",
          "enum": [
            "strong",
            "moderate",
            "weak",
            "none"
          ],
          "title": "Truth Strength",
          "default": "none"
        },
        "match_key": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Match Key"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Title"
        },
        "route_path": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Route Path"
        },
        "request_schema": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Request Schema"
        },
        "response_schema": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Response Schema"
        },
        "methods": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Methods"
        },
        "listing_detected": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Listing Detected"
        },
        "provider_wallet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Provider Wallet"
        },
        "payment_network": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Payment Network"
        },
        "payment_asset": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Payment Asset"
        },
        "notes": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Notes"
        }
      },
      "type": "object",
      "required": [
        "surface",
        "status"
      ],
      "title": "A2AAuditSurfaceStatus"
    },
    "A2AAuditSurfaceSummary": {
      "properties": {
        "local": {
          "$ref": "#/$defs/A2AAuditSurfaceStatus"
        },
        "public": {
          "$ref": "#/$defs/A2AAuditSurfaceStatus"
        },
        "runtime": {
          "$ref": "#/$defs/A2AAuditSurfaceStatus"
        },
        "dispatch": {
          "anyOf": [
            {
              "$ref": "#/$defs/A2AAuditSurfaceStatus"
            },
            {
              "type": "null"
            }
          ]
        },
        "wallet_truth": {
          "anyOf": [
            {
              "$ref": "#/$defs/A2AAuditSurfaceStatus"
            },
            {
              "type": "null"
            }
          ]
        },
        "delivery_guarantee": {
          "anyOf": [
            {
              "$ref": "#/$defs/A2AAuditSurfaceStatus"
            },
            {
              "type": "null"
            }
          ]
        },
        "evidence_sources": {
          "items": {
            "$ref": "#/$defs/A2AAuditEvidenceSource"
          },
          "type": "array",
          "title": "Evidence Sources"
        }
      },
      "type": "object",
      "required": [
        "local",
        "public",
        "runtime"
      ],
      "title": "A2AAuditSurfaceSummary"
    },
    "A2AAuditWalletObservation": {
      "properties": {
        "role": {
          "type": "string",
          "enum": [
            "identity_wallet",
            "provider_wallet",
            "listing_wallet",
            "runtime_announced_wallet",
            "dispatch_proven_wallet"
          ],
          "title": "Role"
        },
        "value": {
          "type": "string",
          "title": "Value"
        },
        "source_surface": {
          "type": "string",
          "title": "Source Surface"
        },
        "inference": {
          "type": "string",
          "enum": [
            "explicit",
            "surface_inferred",
            "seam_resolved"
          ],
          "title": "Inference"
        },
        "truth_strength": {
          "type": "string",
          "enum": [
            "strong",
            "moderate",
            "weak",
            "none"
          ],
          "title": "Truth Strength",
          "default": "weak"
        },
        "is_canonical": {
          "type": "boolean",
          "title": "Is Canonical",
          "default": false
        }
      },
      "type": "object",
      "required": [
        "role",
        "value",
        "source_surface",
        "inference"
      ],
      "title": "A2AAuditWalletObservation"
    },
    "A2AAuditWalletTruthSummary": {
      "properties": {
        "canonical_provider_wallet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Canonical Provider Wallet"
        },
        "observations": {
          "items": {
            "$ref": "#/$defs/A2AAuditWalletObservation"
          },
          "type": "array",
          "title": "Observations"
        },
        "mismatch_roles": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Mismatch Roles"
        },
        "notes": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Notes"
        }
      },
      "type": "object",
      "title": "A2AAuditWalletTruthSummary"
    },
    "A2AAuditWarning": {
      "properties": {
        "code": {
          "type": "string",
          "title": "Code"
        },
        "message": {
          "type": "string",
          "title": "Message"
        },
        "severity": {
          "type": "string",
          "enum": [
            "info",
            "warning",
            "critical"
          ],
          "title": "Severity",
          "default": "warning"
        },
        "blocker_class": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "launch_blocker",
                "scale_blocker",
                "premium_sale_blocker",
                "advisory"
              ]
            },
            {
              "type": "null"
            }
          ],
          "title": "Blocker Class"
        }
      },
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "title": "A2AAuditWarning"
    }
  }
}