Skip to main content
Glama

Compare OpenAPI contracts

fresh402_openapi_contract_diff
Destructive

Observes public documents without modifying their source. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Use for bounded directional OpenAPI3.0/3.1 JSON contract-change evidence, including supported paths/operations, required fields, types/enums/null and authentication. Use exactly one real watch_id from free unfiltered registration or contracts:{before,after} serialized JSON or bounded YAML 1.2 strings (256,000 characters and UTF-8 bytes each/512,000 combined bytes; only supplied-OpenAPI requests allow a 786,432-byte total envelope). Supplied pairs compare before to after without a fetch or saved watch; omit comparison overrides. Same price and original-operation recovery. Stored mode has no URL override. compare_to: previous(default) or baseline; previous_hash overrides with supported retained evidence. First stored-watch call seeds contract history; explicit pairs compare immediately and return a conservative CI verdict. No YAML watch sources, external-reference fetch or endpoint execution; bounded YAML is supplied-pair only; uncertainty requires review, not a complete compatibility proof. Save and reuse watch IDs across sessions. For a complete single-charge server workflow, use API Compatibility Review when advertised. Rules v3 adds finite numeric/exclusive integer bounds, scalar const in3.1, scalar-item array cardinality and otherwise-identical boolean object closure. Unsupported constraint interactions remain review_required. Optional review contains stable finding IDs, affected operations, bounded excerpts and CI0/1/2; no customer-code inspection or release-safety guarantee. $0.020 USDC/call on Base (eip155:8453), including cache hits. Needs an x402-capable MCP payment client and funded native-USDC payer; ordinary MCP returns a payment challenge. Optional MPP (root mpp_payments.enabled): mppx, org.paymentauth/credential. Prepaid: X-Fresh402-API-Key plus params._meta["fresh402/prepaid"] {idempotency_key,tariff_version,max_credits}; inspect authenticated quote. Choose one billing method; never auto-pay. Persist original proof/input/private recovery token; recover originals after uncertainty. Circle only if root circle_gateway.enabled. Clients, limits and recovery: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.

Input Schema

NameRequiredDescriptionDefault
watch_idNoExisting watch ID: 'w_' plus 32 lowercase hexadecimal characters. Required unless contracts is supplied; these inputs are exclusive. Obtain it with free Register using the public JSON OpenAPI 3.0/3.1 URL and no selector or ignore rules. Reuses the saved URL. No URL override, YAML or scoped/filtered watches.
contractsNoExplicit CI comparison, exclusive with a stored source/watch. Combined contract text <=512,000 UTF-8 bytes; only these two supplied-OpenAPI products allow a complete HTTP/MCP envelope <=786,432 bytes, including JSON escaping and payment metadata. All parser, reference, work and output budgets still apply. No source fetches or saved observation; the original authorized operation remains durably recoverable.
compare_toNoOptional mode: 'previous' (default) compares with the latest saved OpenAPI Contract Diff snapshot; 'baseline' uses its fixed saved baseline. Before contract history exists, the current registered watch state seeds the initial baseline. previous_hash overrides the mode. 'hash' appears only in results, not as an accepted input mode.previous
previous_hashNoOptional 64-character hexadecimal reference hash, case-insensitive. Prefer a hash returned by OpenAPI Contract Diff for this same watch, matching a retained contract snapshot or fixed baseline. The current registered core hash is also accepted as a fallback: without a matching contract snapshot, the fixed baseline (or registered state if no baseline exists) is used. Overrides compare_to; unavailable hashes return 404. Omit to use the selected mode.

Output Schema

NameRequiredDescriptionDefault
urlNo
hashNo
countsNo
reviewNoVersioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.
changedNo
changesNo
verdictNo
warningsNo
watch_idNo
algorithmNo
final_urlNo
compare_toNo
fetched_atNo
work_unitsNo
assumptionsNo
compared_atNo
input_sourceNo
contract_viewNo
previous_hashNo
rules_versionNo
source_fetchesNo
descriptive_onlyNo
openapi_versionsNo
changes_truncatedNo
comparison_sourceNo
observation_savedNo
source_provenanceNo
semantic_model_usedNo
reference_resolutionsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • changedInput schema / properties / contracts / description
      Previous value: -"Explicit CI comparison, exclusive with a stored source/watch. Combined contract text <=48,000 UTF-8 bytes; the complete HTTP/MCP envelope still has its existing 65,536-byte ceiling. References are resolved locally only. Zero source fetches and no saved watch/observation; the original authorized operation remains durably recoverable."New value: +"Explicit CI comparison, exclusive with a stored source/watch. Combined contract text <=512,000 UTF-8 bytes; only these two supplied-OpenAPI products allow a complete HTTP/MCP envelope <=786,432 bytes, including JSON escaping and payment metadata. All parser, reference, work and output budgets still apply. No source fetches or saved observation; the original authorized operation remains durably recoverable."
    • changedInput schema / properties / contracts / properties / after / description
      Previous value: -"New complete OpenAPI 3.0/3.1 contract serialized as a JSON or bounded YAML 1.2 string; at most 24,000 characters, same YAML restrictions as before. Direction is before to after; source authenticity and deployed API behavior are not verified."New value: +"New complete OpenAPI 3.0/3.1 contract serialized as JSON or bounded YAML 1.2; at most 256,000 characters and 256,000 UTF-8 bytes, same restrictions as before. Direction is before to after; source authenticity and deployed behavior are not verified."
    • changedInput schema / properties / contracts / properties / after / maxLength
      Previous value: -24000New value: +256000
    • changedInput schema / properties / contracts / properties / before / description
      Previous value: -"Old complete OpenAPI 3.0/3.1 contract serialized as a JSON or bounded YAML 1.2 string; at most 24,000 characters. YAML rejects anchors/aliases, tags, merges, duplicate or complex keys and nonfinite values. No URLs, executed code or remote-reference fetching."New value: +"Old complete OpenAPI 3.0/3.1 contract serialized as JSON or bounded YAML 1.2; at most 256,000 characters and 256,000 UTF-8 bytes. Duplicate JSON names are rejected. YAML rejects anchors/aliases, tags, merges, duplicate or complex keys and nonfinite values. No executed code or remote-reference fetching."
    • changedInput schema / properties / contracts / properties / before / maxLength
      Previous value: -24000New value: +256000
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "oneOf": [
      -      {
      -        "not": {
      -          "required": [
      -            "input_source"
      -          ]
      -        },
      -        "required": [
      -          "watch_id"
      -        ]
      -      },
      -      {
      -        "not": {
      -          "required": [
      -            "watch_id"
      -          ]
      -        },
      -        "properties": {
      -          "input_source": {
      -            "const": "supplied_contracts"
      -          }
      -        },
      -        "required": [
      -          "input_source",
      -          "verdict",
      -          "compared_at",
      -          "source_fetches",
      -          "observation_saved"
      -        ]
      -      }
      -    ],
      -    "properties": {
      -      "algorithm": {
      -        "type": "string"
      -      },
      -      "assumptions": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "changed": {
      -        "type": "boolean"
      -      },
      -      "changes": {
      -        "items": {
      -          "properties": {
      -            "after": {
      -              "type": "string"
      -            },
      -            "before": {
      -              "type": "string"
      -            },
      -            "classification": {
      -              "enum": [
      -                "definitely_breaking",
      -                "potentially_breaking",
      -                "additive",
      -                "unclassified"
      -              ]
      -            },
      -            "evidence_index": {
      -              "description": "Opt-in contract view only: index in the full original durable changes list.",
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "rule": {
      -              "type": "string"
      -            },
      -            "scope": {
      -              "enum": [
      -                "selected_operation",
      -                "shared_or_unknown"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "classification",
      -            "rule",
      -            "path"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "changes_truncated": {
      -        "type": "boolean"
      -      },
      -      "compare_to": {
      -        "enum": [
      -          "previous",
      -          "baseline",
      -          "hash",
      -          "supplied"
      -        ]
      -      },
      -      "compared_at": {
      -        "type": "string"
      -      },
      -      "comparison_source": {
      -        "type": "string"
      -      },
      -      "contract_view": {
      -        "properties": {
      -          "counts_scope": {
      -            "const": "full_document"
      -          },
      -          "excluded_operation_changes": {
      -            "type": "integer"
      -          },
      -          "hash_scope": {
      -            "type": "string"
      -          },
      -          "limitation": {
      -            "type": "string"
      -          },
      -          "original_result_sha256": {
      -            "type": "string"
      -          },
      -          "representation": {
      -            "const": "contract-impact-v1"
      -          },
      -          "status": {
      -            "enum": [
      -              "breaking",
      -              "review_required",
      -              "no_breaking_change_observed"
      -            ]
      -          },
      -          "used_operations": {
      -            "items": {
      -              "properties": {
      -                "method": {
      -                  "enum": [
      -                    "get",
      -                    "put",
      -                    "post",
      -                    "delete",
      -                    "options",
      -                    "head",
      -                    "patch",
      -                    "trace"
      -                  ]
      -                },
      -                "path": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "path",
      -                "method"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "counts": {
      -        "properties": {
      -          "additive": {
      -            "type": "integer"
      -          },
      -          "definitely_breaking": {
      -            "type": "integer"
      -          },
      -          "potentially_breaking": {
      -            "type": "integer"
      -          },
      -          "unclassified": {
      -            "type": "integer"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "descriptive_only": {
      -        "type": "boolean"
      -      },
      -      "fetched_at": {
      -        "type": "string"
      -      },
      -      "final_url": {
      -        "type": "string"
      -      },
      -      "hash": {
      -        "type": "string"
      -      },
      -      "input_source": {
      -        "const": "supplied_contracts"
      -      },
      -      "observation_saved": {
      -        "type": "boolean"
      -      },
      -      "openapi_versions": {
      -        "properties": {
      -          "after": {
      -            "type": "string"
      -          },
      -          "before": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "previous_hash": {
      -        "type": "string"
      -      },
      -      "reference_resolutions": {
      -        "type": "integer"
      -      },
      -      "review": {
      -        "$schema": "https://json-schema.org/draft/2020-12/schema",
      -        "additionalProperties": false,
      -        "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.",
      -        "properties": {
      -          "comparison_performed": {
      -            "type": "boolean"
      -          },
      -          "complete": {
      -            "type": "boolean"
      -          },
      -          "findings": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "affected_path": {
      -                  "type": "string"
      -                },
      -                "after": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "before": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "compatibility_direction": {
      -                  "enum": [
      -                    "request",
      -                    "response",
      -                    "authentication",
      -                    "operation_or_shared"
      -                  ],
      -                  "type": "string"
      -                },
      -                "complete": {
      -                  "type": "boolean"
      -                },
      -                "confidence": {
      -                  "enum": [
      -                    "supported_rule",
      -                    "requires_review"
      -                  ],
      -                  "type": "string"
      -                },
      -                "evidence": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "after_sha256": {
      -                      "pattern": "^[a-f0-9]{64}$",
      -                      "type": "string"
      -                    },
      -                    "before_sha256": {
      -                      "pattern": "^[a-f0-9]{64}$",
      -                      "type": "string"
      -                    },
      -                    "change_pointer": {
      -                      "type": "string"
      -                    },
      -                    "change_pointer_scope": {
      -                      "const": "full_original_result",
      -                      "type": "string"
      -                    },
      -                    "excerpts_may_be_truncated": {
      -                      "const": true,
      -                      "type": "boolean"
      -                    }
      -                  },
      -                  "required": [
      -                    "change_pointer",
      -                    "change_pointer_scope",
      -                    "before_sha256",
      -                    "after_sha256",
      -                    "excerpts_may_be_truncated"
      -                  ],
      -                  "type": "object"
      -                },
      -                "explanation": {
      -                  "type": "string"
      -                },
      -                "finding_id": {
      -                  "pattern": "^cf_[a-f0-9]{64}$",
      -                  "type": "string"
      -                },
      -                "operations": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "maxItems": 8,
      -                  "type": "array"
      -                },
      -                "recommended_action": {
      -                  "enum": [
      -                    "block_and_review",
      -                    "inspect_with_other_findings",
      -                    "manual_review"
      -                  ],
      -                  "type": "string"
      -                },
      -                "rule_id": {
      -                  "type": "string"
      -                },
      -                "severity": {
      -                  "enum": [
      -                    "error",
      -                    "warning",
      -                    "info"
      -                  ],
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "finding_id",
      -                "rule_id",
      -                "severity",
      -                "compatibility_direction",
      -                "affected_path",
      -                "operations",
      -                "complete",
      -                "before",
      -                "after",
      -                "explanation",
      -                "evidence",
      -                "confidence",
      -                "recommended_action"
      -              ],
      -              "type": "object"
      -            },
      -            "maxItems": 20,
      -            "type": "array"
      -          },
      -          "findings_omitted": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          },
      -          "findings_total": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          },
      -          "groups": {
      -            "additionalProperties": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "maxItems": 20,
      -              "type": "array"
      -            },
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          "input_fingerprints": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "after_sha256": {
      -                "pattern": "^[a-f0-9]{64}$",
      -                "type": "string"
      -              },
      -              "before_sha256": {
      -                "anyOf": [
      -                  {
      -                    "pattern": "^[a-f0-9]{64}$",
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              }
      -            },
      -            "required": [
      -              "before_sha256",
      -              "after_sha256"
      -            ],
      -            "type": "object"
      -          },
      -          "reason": {
      -            "enum": [
      -              "baseline_seeded",
      -              "hash_unchanged"
      -            ],
      -            "type": "string"
      -          },
      -          "result_id": {
      -            "pattern": "^review_[a-f0-9]{64}$",
      -            "type": "string"
      -          },
      -          "schema": {
      -            "const": "fresh402-contract-review-v1",
      -            "type": "string"
      -          },
      -          "scope": {
      -            "type": "string"
      -          },
      -          "verdict": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "ci_exit_code": {
      -                "anyOf": [
      -                  {
      -                    "const": 0,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "const": 1,
      -                    "type": "number"
      -                  },
      -                  {
      -                    "const": 2,
      -                    "type": "number"
      -                  }
      -                ]
      -              },
      -              "live_api_verified": {
      -                "const": false,
      -                "type": "boolean"
      -              },
      -              "scope": {
      -                "type": "string"
      -              },
      -              "status": {
      -                "enum": [
      -                  "breaking",
      -                  "review_required",
      -                  "no_breaking_change_observed",
      -                  "not_compared"
      -                ],
      -                "type": "string"
      -              },
      -              "unsupported_features_require_review": {
      -                "const": true,
      -                "type": "boolean"
      -              }
      -            },
      -            "required": [
      -              "status",
      -              "ci_exit_code",
      -              "live_api_verified"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "schema",
      -          "comparison_performed",
      -          "verdict",
      -          "input_fingerprints",
      -          "findings",
      -          "findings_total",
      -          "findings_omitted",
      -          "groups",
      -          "complete"
      -        ],
      -        "type": "object"
      -      },
      -      "rules_version": {
      -        "type": "integer"
      -      },
      -      "semantic_model_used": {
      -        "type": "boolean"
      -      },
      -      "source_fetches": {
      -        "type": "integer"
      -      },
      -      "source_provenance": {
      -        "properties": {
      -          "after_sha256": {
      -            "type": "string"
      -          },
      -          "baseline_at": {
      -            "type": "string"
      -          },
      -          "baseline_url": {
      -            "type": "string"
      -          },
      -          "before_sha256": {
      -            "type": "string"
      -          },
      -          "final_url": {
      -            "type": "string"
      -          },
      -          "input_source": {
      -            "type": "string"
      -          },
      -          "raw_source_hash": {
      -            "type": "string"
      -          },
      -          "registered_core_hash": {
      -            "type": "string"
      -          },
      -          "requested_url": {
      -            "type": "string"
      -          },
      -          "source_authenticity": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "url": {
      -        "type": "string"
      -      },
      -      "verdict": {
      -        "properties": {
      -          "ci_exit_code": {
      -            "type": "integer"
      -          },
      -          "live_api_verified": {
      -            "type": "boolean"
      -          },
      -          "scope": {
      -            "type": "string"
      -          },
      -          "status": {
      -            "enum": [
      -              "breaking",
      -              "review_required",
      -              "no_breaking_change_observed"
      -            ]
      -          },
      -          "unsupported_features_require_review": {
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "warnings": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "watch_id": {
      -        "type": "string"
      -      },
      -      "work_units": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "hash",
      -      "previous_hash",
      -      "changed",
      -      "changes",
      -      "counts",
      -      "source_provenance",
      -      "rules_version"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Tool error only; accompanied by isError=true.",
      -    "properties": {
      -      "error": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "retryable": {
      -        "type": "boolean"
      -      },
      -      "status": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      -    "properties": {
      -      "accepts": {
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "resource": {
      -        "type": "object"
      -      },
      -      "x402Version": {
      -        "const": 2
      -      }
      -    },
      -    "required": [
      -      "x402Version",
      -      "accepts"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "input_source"
      +          ]
      +        },
      +        "required": [
      +          "watch_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "watch_id"
      +          ]
      +        },
      +        "properties": {
      +          "input_source": {
      +            "const": "supplied_contracts"
      +          }
      +        },
      +        "required": [
      +          "input_source",
      +          "verdict",
      +          "compared_at",
      +          "source_fetches",
      +          "observation_saved"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "algorithm": {
      +        "type": "string"
      +      },
      +      "assumptions": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "changed": {
      +        "type": "boolean"
      +      },
      +      "changes": {
      +        "items": {
      +          "properties": {
      +            "after": {
      +              "type": "string"
      +            },
      +            "before": {
      +              "type": "string"
      +            },
      +            "classification": {
      +              "enum": [
      +                "definitely_breaking",
      +                "potentially_breaking",
      +                "additive",
      +                "unclassified"
      +              ]
      +            },
      +            "evidence_index": {
      +              "description": "Opt-in contract view only: index in the full original durable changes list.",
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "rule": {
      +              "type": "string"
      +            },
      +            "scope": {
      +              "enum": [
      +                "selected_operation",
      +                "shared_or_unknown"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "classification",
      +            "rule",
      +            "path"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "changes_truncated": {
      +        "type": "boolean"
      +      },
      +      "compare_to": {
      +        "enum": [
      +          "previous",
      +          "baseline",
      +          "hash",
      +          "supplied"
      +        ]
      +      },
      +      "compared_at": {
      +        "type": "string"
      +      },
      +      "comparison_source": {
      +        "type": "string"
      +      },
      +      "contract_view": {
      +        "properties": {
      +          "counts_scope": {
      +            "const": "full_document"
      +          },
      +          "excluded_operation_changes": {
      +            "type": "integer"
      +          },
      +          "hash_scope": {
      +            "type": "string"
      +          },
      +          "limitation": {
      +            "type": "string"
      +          },
      +          "original_result_sha256": {
      +            "type": "string"
      +          },
      +          "representation": {
      +            "const": "contract-impact-v1"
      +          },
      +          "status": {
      +            "enum": [
      +              "breaking",
      +              "review_required",
      +              "no_breaking_change_observed"
      +            ]
      +          },
      +          "used_operations": {
      +            "items": {
      +              "properties": {
      +                "method": {
      +                  "enum": [
      +                    "get",
      +                    "put",
      +                    "post",
      +                    "delete",
      +                    "options",
      +                    "head",
      +                    "patch",
      +                    "trace"
      +                  ]
      +                },
      +                "path": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "path",
      +                "method"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "counts": {
      +        "properties": {
      +          "additive": {
      +            "type": "integer"
      +          },
      +          "definitely_breaking": {
      +            "type": "integer"
      +          },
      +          "potentially_breaking": {
      +            "type": "integer"
      +          },
      +          "unclassified": {
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "descriptive_only": {
      +        "type": "boolean"
      +      },
      +      "fetched_at": {
      +        "type": "string"
      +      },
      +      "final_url": {
      +        "type": "string"
      +      },
      +      "hash": {
      +        "type": "string"
      +      },
      +      "input_source": {
      +        "const": "supplied_contracts"
      +      },
      +      "observation_saved": {
      +        "type": "boolean"
      +      },
      +      "openapi_versions": {
      +        "properties": {
      +          "after": {
      +            "type": "string"
      +          },
      +          "before": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "previous_hash": {
      +        "type": "string"
      +      },
      +      "reference_resolutions": {
      +        "type": "integer"
      +      },
      +      "review": {
      +        "$schema": "https://json-schema.org/draft/2020-12/schema",
      +        "additionalProperties": false,
      +        "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.",
      +        "properties": {
      +          "comparison_performed": {
      +            "type": "boolean"
      +          },
      +          "complete": {
      +            "type": "boolean"
      +          },
      +          "findings": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "affected_path": {
      +                  "type": "string"
      +                },
      +                "after": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "before": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "compatibility_direction": {
      +                  "enum": [
      +                    "request",
      +                    "response",
      +                    "authentication",
      +                    "operation_or_shared"
      +                  ],
      +                  "type": "string"
      +                },
      +                "complete": {
      +                  "type": "boolean"
      +                },
      +                "confidence": {
      +                  "enum": [
      +                    "supported_rule",
      +                    "requires_review"
      +                  ],
      +                  "type": "string"
      +                },
      +                "evidence": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "after_sha256": {
      +                      "pattern": "^[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "after_source_pointer": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "before_sha256": {
      +                      "pattern": "^[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "before_source_pointer": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "change_pointer": {
      +                      "type": "string"
      +                    },
      +                    "change_pointer_scope": {
      +                      "const": "full_original_result",
      +                      "type": "string"
      +                    },
      +                    "excerpts_may_be_truncated": {
      +                      "const": true,
      +                      "type": "boolean"
      +                    },
      +                    "source_pointer_scope": {
      +                      "const": "parsed_original_contract_declaration",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "change_pointer",
      +                    "change_pointer_scope",
      +                    "before_sha256",
      +                    "after_sha256",
      +                    "excerpts_may_be_truncated"
      +                  ],
      +                  "type": "object"
      +                },
      +                "explanation": {
      +                  "type": "string"
      +                },
      +                "finding_id": {
      +                  "pattern": "^cf_[a-f0-9]{64}$",
      +                  "type": "string"
      +                },
      +                "operations": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "maxItems": 8,
      +                  "type": "array"
      +                },
      +                "recommended_action": {
      +                  "enum": [
      +                    "block_and_review",
      +                    "inspect_with_other_findings",
      +                    "manual_review"
      +                  ],
      +                  "type": "string"
      +                },
      +                "rule_id": {
      +                  "type": "string"
      +                },
      +                "severity": {
      +                  "enum": [
      +                    "error",
      +                    "warning",
      +                    "info"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "finding_id",
      +                "rule_id",
      +                "severity",
      +                "compatibility_direction",
      +                "affected_path",
      +                "operations",
      +                "complete",
      +                "before",
      +                "after",
      +                "explanation",
      +                "evidence",
      +                "confidence",
      +                "recommended_action"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 20,
      +            "type": "array"
      +          },
      +          "findings_omitted": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "findings_total": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "groups": {
      +            "additionalProperties": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "maxItems": 20,
      +              "type": "array"
      +            },
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "input_fingerprints": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "after_sha256": {
      +                "pattern": "^[a-f0-9]{64}$",
      +                "type": "string"
      +              },
      +              "before_sha256": {
      +                "anyOf": [
      +                  {
      +                    "pattern": "^[a-f0-9]{64}$",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              }
      +            },
      +            "required": [
      +              "before_sha256",
      +              "after_sha256"
      +            ],
      +            "type": "object"
      +          },
      +          "reason": {
      +            "enum": [
      +              "baseline_seeded",
      +              "hash_unchanged"
      +            ],
      +            "type": "string"
      +          },
      +          "result_id": {
      +            "pattern": "^review_[a-f0-9]{64}$",
      +            "type": "string"
      +          },
      +          "schema": {
      +            "const": "fresh402-contract-review-v1",
      +            "type": "string"
      +          },
      +          "scope": {
      +            "type": "string"
      +          },
      +          "verdict": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "ci_exit_code": {
      +                "anyOf": [
      +                  {
      +                    "const": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "const": 1,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "const": 2,
      +                    "type": "number"
      +                  }
      +                ]
      +              },
      +              "live_api_verified": {
      +                "const": false,
      +                "type": "boolean"
      +              },
      +              "scope": {
      +                "type": "string"
      +              },
      +              "status": {
      +                "enum": [
      +                  "breaking",
      +                  "review_required",
      +                  "no_breaking_change_observed",
      +                  "not_compared"
      +                ],
      +                "type": "string"
      +              },
      +              "unsupported_features_require_review": {
      +                "const": true,
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "status",
      +              "ci_exit_code",
      +              "live_api_verified"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "schema",
      +          "comparison_performed",
      +          "verdict",
      +          "input_fingerprints",
      +          "findings",
      +          "findings_total",
      +          "findings_omitted",
      +          "groups",
      +          "complete"
      +        ],
      +        "type": "object"
      +      },
      +      "rules_version": {
      +        "type": "integer"
      +      },
      +      "semantic_model_used": {
      +        "type": "boolean"
      +      },
      +      "source_fetches": {
      +        "type": "integer"
      +      },
      +      "source_provenance": {
      +        "properties": {
      +          "after_input_sha256": {
      +            "type": "string"
      +          },
      +          "after_sha256": {
      +            "type": "string"
      +          },
      +          "baseline_at": {
      +            "type": "string"
      +          },
      +          "baseline_url": {
      +            "type": "string"
      +          },
      +          "before_input_sha256": {
      +            "type": "string"
      +          },
      +          "before_sha256": {
      +            "type": "string"
      +          },
      +          "final_url": {
      +            "type": "string"
      +          },
      +          "fingerprint_scope": {
      +            "type": "string"
      +          },
      +          "input_source": {
      +            "type": "string"
      +          },
      +          "raw_source_hash": {
      +            "type": "string"
      +          },
      +          "registered_core_hash": {
      +            "type": "string"
      +          },
      +          "requested_url": {
      +            "type": "string"
      +          },
      +          "source_authenticity": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "url": {
      +        "type": "string"
      +      },
      +      "verdict": {
      +        "properties": {
      +          "ci_exit_code": {
      +            "type": "integer"
      +          },
      +          "live_api_verified": {
      +            "type": "boolean"
      +          },
      +          "scope": {
      +            "type": "string"
      +          },
      +          "status": {
      +            "enum": [
      +              "breaking",
      +              "review_required",
      +              "no_breaking_change_observed"
      +            ]
      +          },
      +          "unsupported_features_require_review": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "warnings": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "watch_id": {
      +        "type": "string"
      +      },
      +      "work_units": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "hash",
      +      "previous_hash",
      +      "changed",
      +      "changes",
      +      "counts",
      +      "source_provenance",
      +      "rules_version"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Tool error only; accompanied by isError=true.",
      +    "properties": {
      +      "error": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "retryable": {
      +        "type": "boolean"
      +      },
      +      "status": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      +    "properties": {
      +      "accepts": {
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "resource": {
      +        "type": "object"
      +      },
      +      "x402Version": {
      +        "const": 2
      +      }
      +    },
      +    "required": [
      +      "x402Version",
      +      "accepts"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedOutput schema / properties / review / properties / findings / items / properties / evidence / properties / after_source_pointer
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / review / properties / findings / items / properties / evidence / properties / before_source_pointer
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / review / properties / findings / items / properties / evidence / properties / source_pointer_scope
      Added value: +{
      +  "const": "parsed_original_contract_declaration",
      +  "type": "string"
      +}
    • addedOutput schema / properties / source_provenance / properties / after_input_sha256
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / source_provenance / properties / before_input_sha256
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / source_provenance / properties / fingerprint_scope
      Added value: +{
      +  "type": "string"
      +}
  2. Changed2 schema fields changed
    • changedInput schema / properties / contracts / properties / after / description
      Previous value: -"New complete JSON OpenAPI 3.0/3.1 contract serialized as a string; at most 24,000 characters. Direction is before to after; source authenticity and deployed API behavior are not verified."New value: +"New complete OpenAPI 3.0/3.1 contract serialized as a JSON or bounded YAML 1.2 string; at most 24,000 characters, same YAML restrictions as before. Direction is before to after; source authenticity and deployed API behavior are not verified."
    • changedInput schema / properties / contracts / properties / before / description
      Previous value: -"Old complete JSON OpenAPI 3.0/3.1 contract serialized as a string; at most 24,000 characters. No YAML, URLs, executed code or remote-reference fetching."New value: +"Old complete OpenAPI 3.0/3.1 contract serialized as a JSON or bounded YAML 1.2 string; at most 24,000 characters. YAML rejects anchors/aliases, tags, merges, duplicate or complex keys and nonfinite values. No URLs, executed code or remote-reference fetching."
  3. Changed2 schema fields changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "oneOf": [
      -      {
      -        "not": {
      -          "required": [
      -            "input_source"
      -          ]
      -        },
      -        "required": [
      -          "watch_id"
      -        ]
      -      },
      -      {
      -        "not": {
      -          "required": [
      -            "watch_id"
      -          ]
      -        },
      -        "properties": {
      -          "input_source": {
      -            "const": "supplied_contracts"
      -          }
      -        },
      -        "required": [
      -          "input_source",
      -          "verdict",
      -          "compared_at",
      -          "source_fetches",
      -          "observation_saved"
      -        ]
      -      }
      -    ],
      -    "properties": {
      -      "algorithm": {
      -        "type": "string"
      -      },
      -      "assumptions": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "changed": {
      -        "type": "boolean"
      -      },
      -      "changes": {
      -        "items": {
      -          "properties": {
      -            "after": {
      -              "type": "string"
      -            },
      -            "before": {
      -              "type": "string"
      -            },
      -            "classification": {
      -              "enum": [
      -                "definitely_breaking",
      -                "potentially_breaking",
      -                "additive",
      -                "unclassified"
      -              ]
      -            },
      -            "evidence_index": {
      -              "description": "Opt-in contract view only: index in the full original durable changes list.",
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "rule": {
      -              "type": "string"
      -            },
      -            "scope": {
      -              "enum": [
      -                "selected_operation",
      -                "shared_or_unknown"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "classification",
      -            "rule",
      -            "path"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "changes_truncated": {
      -        "type": "boolean"
      -      },
      -      "compare_to": {
      -        "enum": [
      -          "previous",
      -          "baseline",
      -          "hash",
      -          "supplied"
      -        ]
      -      },
      -      "compared_at": {
      -        "type": "string"
      -      },
      -      "comparison_source": {
      -        "type": "string"
      -      },
      -      "contract_view": {
      -        "properties": {
      -          "counts_scope": {
      -            "const": "full_document"
      -          },
      -          "excluded_operation_changes": {
      -            "type": "integer"
      -          },
      -          "hash_scope": {
      -            "type": "string"
      -          },
      -          "limitation": {
      -            "type": "string"
      -          },
      -          "original_result_sha256": {
      -            "type": "string"
      -          },
      -          "representation": {
      -            "const": "contract-impact-v1"
      -          },
      -          "status": {
      -            "enum": [
      -              "breaking",
      -              "review_required",
      -              "no_breaking_change_observed"
      -            ]
      -          },
      -          "used_operations": {
      -            "items": {
      -              "properties": {
      -                "method": {
      -                  "enum": [
      -                    "get",
      -                    "put",
      -                    "post",
      -                    "delete",
      -                    "options",
      -                    "head",
      -                    "patch",
      -                    "trace"
      -                  ]
      -                },
      -                "path": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "path",
      -                "method"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "counts": {
      -        "properties": {
      -          "additive": {
      -            "type": "integer"
      -          },
      -          "definitely_breaking": {
      -            "type": "integer"
      -          },
      -          "potentially_breaking": {
      -            "type": "integer"
      -          },
      -          "unclassified": {
      -            "type": "integer"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "descriptive_only": {
      -        "type": "boolean"
      -      },
      -      "fetched_at": {
      -        "type": "string"
      -      },
      -      "final_url": {
      -        "type": "string"
      -      },
      -      "hash": {
      -        "type": "string"
      -      },
      -      "input_source": {
      -        "const": "supplied_contracts"
      -      },
      -      "observation_saved": {
      -        "type": "boolean"
      -      },
      -      "openapi_versions": {
      -        "properties": {
      -          "after": {
      -            "type": "string"
      -          },
      -          "before": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "previous_hash": {
      -        "type": "string"
      -      },
      -      "reference_resolutions": {
      -        "type": "integer"
      -      },
      -      "rules_version": {
      -        "type": "integer"
      -      },
      -      "semantic_model_used": {
      -        "type": "boolean"
      -      },
      -      "source_fetches": {
      -        "type": "integer"
      -      },
      -      "source_provenance": {
      -        "properties": {
      -          "after_sha256": {
      -            "type": "string"
      -          },
      -          "baseline_at": {
      -            "type": "string"
      -          },
      -          "baseline_url": {
      -            "type": "string"
      -          },
      -          "before_sha256": {
      -            "type": "string"
      -          },
      -          "final_url": {
      -            "type": "string"
      -          },
      -          "input_source": {
      -            "type": "string"
      -          },
      -          "raw_source_hash": {
      -            "type": "string"
      -          },
      -          "registered_core_hash": {
      -            "type": "string"
      -          },
      -          "requested_url": {
      -            "type": "string"
      -          },
      -          "source_authenticity": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "url": {
      -        "type": "string"
      -      },
      -      "verdict": {
      -        "properties": {
      -          "ci_exit_code": {
      -            "type": "integer"
      -          },
      -          "live_api_verified": {
      -            "type": "boolean"
      -          },
      -          "scope": {
      -            "type": "string"
      -          },
      -          "status": {
      -            "enum": [
      -              "breaking",
      -              "review_required",
      -              "no_breaking_change_observed"
      -            ]
      -          },
      -          "unsupported_features_require_review": {
      -            "type": "boolean"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "warnings": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "watch_id": {
      -        "type": "string"
      -      },
      -      "work_units": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "hash",
      -      "previous_hash",
      -      "changed",
      -      "changes",
      -      "counts",
      -      "source_provenance",
      -      "rules_version"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Tool error only; accompanied by isError=true.",
      -    "properties": {
      -      "error": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "retryable": {
      -        "type": "boolean"
      -      },
      -      "status": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      -    "properties": {
      -      "accepts": {
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "resource": {
      -        "type": "object"
      -      },
      -      "x402Version": {
      -        "const": 2
      -      }
      -    },
      -    "required": [
      -      "x402Version",
      -      "accepts"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "input_source"
      +          ]
      +        },
      +        "required": [
      +          "watch_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "watch_id"
      +          ]
      +        },
      +        "properties": {
      +          "input_source": {
      +            "const": "supplied_contracts"
      +          }
      +        },
      +        "required": [
      +          "input_source",
      +          "verdict",
      +          "compared_at",
      +          "source_fetches",
      +          "observation_saved"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "algorithm": {
      +        "type": "string"
      +      },
      +      "assumptions": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "changed": {
      +        "type": "boolean"
      +      },
      +      "changes": {
      +        "items": {
      +          "properties": {
      +            "after": {
      +              "type": "string"
      +            },
      +            "before": {
      +              "type": "string"
      +            },
      +            "classification": {
      +              "enum": [
      +                "definitely_breaking",
      +                "potentially_breaking",
      +                "additive",
      +                "unclassified"
      +              ]
      +            },
      +            "evidence_index": {
      +              "description": "Opt-in contract view only: index in the full original durable changes list.",
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "rule": {
      +              "type": "string"
      +            },
      +            "scope": {
      +              "enum": [
      +                "selected_operation",
      +                "shared_or_unknown"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "classification",
      +            "rule",
      +            "path"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "changes_truncated": {
      +        "type": "boolean"
      +      },
      +      "compare_to": {
      +        "enum": [
      +          "previous",
      +          "baseline",
      +          "hash",
      +          "supplied"
      +        ]
      +      },
      +      "compared_at": {
      +        "type": "string"
      +      },
      +      "comparison_source": {
      +        "type": "string"
      +      },
      +      "contract_view": {
      +        "properties": {
      +          "counts_scope": {
      +            "const": "full_document"
      +          },
      +          "excluded_operation_changes": {
      +            "type": "integer"
      +          },
      +          "hash_scope": {
      +            "type": "string"
      +          },
      +          "limitation": {
      +            "type": "string"
      +          },
      +          "original_result_sha256": {
      +            "type": "string"
      +          },
      +          "representation": {
      +            "const": "contract-impact-v1"
      +          },
      +          "status": {
      +            "enum": [
      +              "breaking",
      +              "review_required",
      +              "no_breaking_change_observed"
      +            ]
      +          },
      +          "used_operations": {
      +            "items": {
      +              "properties": {
      +                "method": {
      +                  "enum": [
      +                    "get",
      +                    "put",
      +                    "post",
      +                    "delete",
      +                    "options",
      +                    "head",
      +                    "patch",
      +                    "trace"
      +                  ]
      +                },
      +                "path": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "path",
      +                "method"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "counts": {
      +        "properties": {
      +          "additive": {
      +            "type": "integer"
      +          },
      +          "definitely_breaking": {
      +            "type": "integer"
      +          },
      +          "potentially_breaking": {
      +            "type": "integer"
      +          },
      +          "unclassified": {
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "descriptive_only": {
      +        "type": "boolean"
      +      },
      +      "fetched_at": {
      +        "type": "string"
      +      },
      +      "final_url": {
      +        "type": "string"
      +      },
      +      "hash": {
      +        "type": "string"
      +      },
      +      "input_source": {
      +        "const": "supplied_contracts"
      +      },
      +      "observation_saved": {
      +        "type": "boolean"
      +      },
      +      "openapi_versions": {
      +        "properties": {
      +          "after": {
      +            "type": "string"
      +          },
      +          "before": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "previous_hash": {
      +        "type": "string"
      +      },
      +      "reference_resolutions": {
      +        "type": "integer"
      +      },
      +      "review": {
      +        "$schema": "https://json-schema.org/draft/2020-12/schema",
      +        "additionalProperties": false,
      +        "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.",
      +        "properties": {
      +          "comparison_performed": {
      +            "type": "boolean"
      +          },
      +          "complete": {
      +            "type": "boolean"
      +          },
      +          "findings": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "affected_path": {
      +                  "type": "string"
      +                },
      +                "after": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "before": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "compatibility_direction": {
      +                  "enum": [
      +                    "request",
      +                    "response",
      +                    "authentication",
      +                    "operation_or_shared"
      +                  ],
      +                  "type": "string"
      +                },
      +                "complete": {
      +                  "type": "boolean"
      +                },
      +                "confidence": {
      +                  "enum": [
      +                    "supported_rule",
      +                    "requires_review"
      +                  ],
      +                  "type": "string"
      +                },
      +                "evidence": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "after_sha256": {
      +                      "pattern": "^[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "before_sha256": {
      +                      "pattern": "^[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "change_pointer": {
      +                      "type": "string"
      +                    },
      +                    "change_pointer_scope": {
      +                      "const": "full_original_result",
      +                      "type": "string"
      +                    },
      +                    "excerpts_may_be_truncated": {
      +                      "const": true,
      +                      "type": "boolean"
      +                    }
      +                  },
      +                  "required": [
      +                    "change_pointer",
      +                    "change_pointer_scope",
      +                    "before_sha256",
      +                    "after_sha256",
      +                    "excerpts_may_be_truncated"
      +                  ],
      +                  "type": "object"
      +                },
      +                "explanation": {
      +                  "type": "string"
      +                },
      +                "finding_id": {
      +                  "pattern": "^cf_[a-f0-9]{64}$",
      +                  "type": "string"
      +                },
      +                "operations": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "maxItems": 8,
      +                  "type": "array"
      +                },
      +                "recommended_action": {
      +                  "enum": [
      +                    "block_and_review",
      +                    "inspect_with_other_findings",
      +                    "manual_review"
      +                  ],
      +                  "type": "string"
      +                },
      +                "rule_id": {
      +                  "type": "string"
      +                },
      +                "severity": {
      +                  "enum": [
      +                    "error",
      +                    "warning",
      +                    "info"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "finding_id",
      +                "rule_id",
      +                "severity",
      +                "compatibility_direction",
      +                "affected_path",
      +                "operations",
      +                "complete",
      +                "before",
      +                "after",
      +                "explanation",
      +                "evidence",
      +                "confidence",
      +                "recommended_action"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 20,
      +            "type": "array"
      +          },
      +          "findings_omitted": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "findings_total": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "groups": {
      +            "additionalProperties": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "maxItems": 20,
      +              "type": "array"
      +            },
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "input_fingerprints": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "after_sha256": {
      +                "pattern": "^[a-f0-9]{64}$",
      +                "type": "string"
      +              },
      +              "before_sha256": {
      +                "anyOf": [
      +                  {
      +                    "pattern": "^[a-f0-9]{64}$",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              }
      +            },
      +            "required": [
      +              "before_sha256",
      +              "after_sha256"
      +            ],
      +            "type": "object"
      +          },
      +          "reason": {
      +            "enum": [
      +              "baseline_seeded",
      +              "hash_unchanged"
      +            ],
      +            "type": "string"
      +          },
      +          "result_id": {
      +            "pattern": "^review_[a-f0-9]{64}$",
      +            "type": "string"
      +          },
      +          "schema": {
      +            "const": "fresh402-contract-review-v1",
      +            "type": "string"
      +          },
      +          "scope": {
      +            "type": "string"
      +          },
      +          "verdict": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "ci_exit_code": {
      +                "anyOf": [
      +                  {
      +                    "const": 0,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "const": 1,
      +                    "type": "number"
      +                  },
      +                  {
      +                    "const": 2,
      +                    "type": "number"
      +                  }
      +                ]
      +              },
      +              "live_api_verified": {
      +                "const": false,
      +                "type": "boolean"
      +              },
      +              "scope": {
      +                "type": "string"
      +              },
      +              "status": {
      +                "enum": [
      +                  "breaking",
      +                  "review_required",
      +                  "no_breaking_change_observed",
      +                  "not_compared"
      +                ],
      +                "type": "string"
      +              },
      +              "unsupported_features_require_review": {
      +                "const": true,
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "status",
      +              "ci_exit_code",
      +              "live_api_verified"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "schema",
      +          "comparison_performed",
      +          "verdict",
      +          "input_fingerprints",
      +          "findings",
      +          "findings_total",
      +          "findings_omitted",
      +          "groups",
      +          "complete"
      +        ],
      +        "type": "object"
      +      },
      +      "rules_version": {
      +        "type": "integer"
      +      },
      +      "semantic_model_used": {
      +        "type": "boolean"
      +      },
      +      "source_fetches": {
      +        "type": "integer"
      +      },
      +      "source_provenance": {
      +        "properties": {
      +          "after_sha256": {
      +            "type": "string"
      +          },
      +          "baseline_at": {
      +            "type": "string"
      +          },
      +          "baseline_url": {
      +            "type": "string"
      +          },
      +          "before_sha256": {
      +            "type": "string"
      +          },
      +          "final_url": {
      +            "type": "string"
      +          },
      +          "input_source": {
      +            "type": "string"
      +          },
      +          "raw_source_hash": {
      +            "type": "string"
      +          },
      +          "registered_core_hash": {
      +            "type": "string"
      +          },
      +          "requested_url": {
      +            "type": "string"
      +          },
      +          "source_authenticity": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "url": {
      +        "type": "string"
      +      },
      +      "verdict": {
      +        "properties": {
      +          "ci_exit_code": {
      +            "type": "integer"
      +          },
      +          "live_api_verified": {
      +            "type": "boolean"
      +          },
      +          "scope": {
      +            "type": "string"
      +          },
      +          "status": {
      +            "enum": [
      +              "breaking",
      +              "review_required",
      +              "no_breaking_change_observed"
      +            ]
      +          },
      +          "unsupported_features_require_review": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "warnings": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "watch_id": {
      +        "type": "string"
      +      },
      +      "work_units": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "hash",
      +      "previous_hash",
      +      "changed",
      +      "changes",
      +      "counts",
      +      "source_provenance",
      +      "rules_version"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Tool error only; accompanied by isError=true.",
      +    "properties": {
      +      "error": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "retryable": {
      +        "type": "boolean"
      +      },
      +      "status": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      +    "properties": {
      +      "accepts": {
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "resource": {
      +        "type": "object"
      +      },
      +      "x402Version": {
      +        "const": 2
      +      }
      +    },
      +    "required": [
      +      "x402Version",
      +      "accepts"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedOutput schema / properties / review
      Added value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.",
      +  "properties": {
      +    "comparison_performed": {
      +      "type": "boolean"
      +    },
      +    "complete": {
      +      "type": "boolean"
      +    },
      +    "findings": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "affected_path": {
      +            "type": "string"
      +          },
      +          "after": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "before": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "compatibility_direction": {
      +            "enum": [
      +              "request",
      +              "response",
      +              "authentication",
      +              "operation_or_shared"
      +            ],
      +            "type": "string"
      +          },
      +          "complete": {
      +            "type": "boolean"
      +          },
      +          "confidence": {
      +            "enum": [
      +              "supported_rule",
      +              "requires_review"
      +            ],
      +            "type": "string"
      +          },
      +          "evidence": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "after_sha256": {
      +                "pattern": "^[a-f0-9]{64}$",
      +                "type": "string"
      +              },
      +              "before_sha256": {
      +                "pattern": "^[a-f0-9]{64}$",
      +                "type": "string"
      +              },
      +              "change_pointer": {
      +                "type": "string"
      +              },
      +              "change_pointer_scope": {
      +                "const": "full_original_result",
      +                "type": "string"
      +              },
      +              "excerpts_may_be_truncated": {
      +                "const": true,
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "change_pointer",
      +              "change_pointer_scope",
      +              "before_sha256",
      +              "after_sha256",
      +              "excerpts_may_be_truncated"
      +            ],
      +            "type": "object"
      +          },
      +          "explanation": {
      +            "type": "string"
      +          },
      +          "finding_id": {
      +            "pattern": "^cf_[a-f0-9]{64}$",
      +            "type": "string"
      +          },
      +          "operations": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "maxItems": 8,
      +            "type": "array"
      +          },
      +          "recommended_action": {
      +            "enum": [
      +              "block_and_review",
      +              "inspect_with_other_findings",
      +              "manual_review"
      +            ],
      +            "type": "string"
      +          },
      +          "rule_id": {
      +            "type": "string"
      +          },
      +          "severity": {
      +            "enum": [
      +              "error",
      +              "warning",
      +              "info"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "finding_id",
      +          "rule_id",
      +          "severity",
      +          "compatibility_direction",
      +          "affected_path",
      +          "operations",
      +          "complete",
      +          "before",
      +          "after",
      +          "explanation",
      +          "evidence",
      +          "confidence",
      +          "recommended_action"
      +        ],
      +        "type": "object"
      +      },
      +      "maxItems": 20,
      +      "type": "array"
      +    },
      +    "findings_omitted": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "findings_total": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "groups": {
      +      "additionalProperties": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "maxItems": 20,
      +        "type": "array"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "input_fingerprints": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "after_sha256": {
      +          "pattern": "^[a-f0-9]{64}$",
      +          "type": "string"
      +        },
      +        "before_sha256": {
      +          "anyOf": [
      +            {
      +              "pattern": "^[a-f0-9]{64}$",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "before_sha256",
      +        "after_sha256"
      +      ],
      +      "type": "object"
      +    },
      +    "reason": {
      +      "enum": [
      +        "baseline_seeded",
      +        "hash_unchanged"
      +      ],
      +      "type": "string"
      +    },
      +    "result_id": {
      +      "pattern": "^review_[a-f0-9]{64}$",
      +      "type": "string"
      +    },
      +    "schema": {
      +      "const": "fresh402-contract-review-v1",
      +      "type": "string"
      +    },
      +    "scope": {
      +      "type": "string"
      +    },
      +    "verdict": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "ci_exit_code": {
      +          "anyOf": [
      +            {
      +              "const": 0,
      +              "type": "number"
      +            },
      +            {
      +              "const": 1,
      +              "type": "number"
      +            },
      +            {
      +              "const": 2,
      +              "type": "number"
      +            }
      +          ]
      +        },
      +        "live_api_verified": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "scope": {
      +          "type": "string"
      +        },
      +        "status": {
      +          "enum": [
      +            "breaking",
      +            "review_required",
      +            "no_breaking_change_observed",
      +            "not_compared"
      +          ],
      +          "type": "string"
      +        },
      +        "unsupported_features_require_review": {
      +          "const": true,
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "status",
      +        "ci_exit_code",
      +        "live_api_verified"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "schema",
      +    "comparison_performed",
      +    "verdict",
      +    "input_fingerprints",
      +    "findings",
      +    "findings_total",
      +    "findings_omitted",
      +    "groups",
      +    "complete"
      +  ],
      +  "type": "object"
      +}
  4. Changed16 schema fields changed
    • changedInput schema / description
      Previous value: -"Compare a registered, unfiltered public JSON OpenAPI 3.0/3.1 contract; watch_id is required, compare_to defaults to previous, and optional previous_hash overrides it. Bounded structural analysis, not a complete compatibility proof; no YAML, external reference fetching or execution of described API operations. Unknown fields are rejected."New value: +"Compare exactly one registered watch or an explicit contracts:{before,after} pair. Stored mode preserves previous/baseline/hash behavior. Supplied mode uses before to after, no fetch, no watch mutation or saved observation; omit comparison overrides. Same existing fixed price and original-operation recovery. Bounded document evidence, not live compatibility proof."
    • addedInput schema / oneOf
      Added value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "contracts"
      +      ]
      +    },
      +    "required": [
      +      "watch_id"
      +    ]
      +  },
      +  {
      +    "not": {
      +      "anyOf": [
      +        {
      +          "required": [
      +            "watch_id"
      +          ]
      +        },
      +        {
      +          "required": [
      +            "previous_hash"
      +          ]
      +        }
      +      ]
      +    },
      +    "properties": {
      +      "compare_to": {
      +        "const": "previous"
      +      }
      +    },
      +    "required": [
      +      "contracts"
      +    ]
      +  }
      +]
    • addedInput schema / properties / contracts
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Explicit CI comparison, exclusive with a stored source/watch. Combined contract text <=48,000 UTF-8 bytes; the complete HTTP/MCP envelope still has its existing 65,536-byte ceiling. References are resolved locally only. Zero source fetches and no saved watch/observation; the original authorized operation remains durably recoverable.",
      +  "properties": {
      +    "after": {
      +      "description": "New complete JSON OpenAPI 3.0/3.1 contract serialized as a string; at most 24,000 characters. Direction is before to after; source authenticity and deployed API behavior are not verified.",
      +      "maxLength": 24000,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "before": {
      +      "description": "Old complete JSON OpenAPI 3.0/3.1 contract serialized as a string; at most 24,000 characters. No YAML, URLs, executed code or remote-reference fetching.",
      +      "maxLength": 24000,
      +      "minLength": 1,
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "before",
      +    "after"
      +  ],
      +  "type": "object"
      +}
    • changedInput schema / properties / watch_id / description
      Previous value: -"Required existing watch ID: 'w_' plus 32 lowercase hexadecimal characters. Obtain it with free fresh402_register or POST /v1/register using the public JSON OpenAPI 3.0/3.1 URL and no selector or ignore rules. Reuses the saved URL; do not pass url here. YAML, non-OpenAPI documents and scoped/filtered watches are unsupported. Illustrative IDs must be replaced."New value: +"Existing watch ID: 'w_' plus 32 lowercase hexadecimal characters. Required unless contracts is supplied; these inputs are exclusive. Obtain it with free Register using the public JSON OpenAPI 3.0/3.1 URL and no selector or ignore rules. Reuses the saved URL. No URL override, YAML or scoped/filtered watches."
    • removedInput schema / required
      Removed value: -[
      -  "watch_id"
      -]
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "algorithm": {
      -        "type": "string"
      -      },
      -      "assumptions": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "changed": {
      -        "type": "boolean"
      -      },
      -      "changes": {
      -        "items": {
      -          "properties": {
      -            "after": {
      -              "type": "string"
      -            },
      -            "before": {
      -              "type": "string"
      -            },
      -            "classification": {
      -              "enum": [
      -                "definitely_breaking",
      -                "potentially_breaking",
      -                "additive",
      -                "unclassified"
      -              ]
      -            },
      -            "evidence_index": {
      -              "description": "Opt-in contract view only: index in the full original durable changes list.",
      -              "minimum": 0,
      -              "type": "integer"
      -            },
      -            "path": {
      -              "type": "string"
      -            },
      -            "rule": {
      -              "type": "string"
      -            },
      -            "scope": {
      -              "enum": [
      -                "selected_operation",
      -                "shared_or_unknown"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "classification",
      -            "rule",
      -            "path"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "changes_truncated": {
      -        "type": "boolean"
      -      },
      -      "compare_to": {
      -        "enum": [
      -          "previous",
      -          "baseline",
      -          "hash"
      -        ]
      -      },
      -      "comparison_source": {
      -        "type": "string"
      -      },
      -      "contract_view": {
      -        "properties": {
      -          "counts_scope": {
      -            "const": "full_document"
      -          },
      -          "excluded_operation_changes": {
      -            "type": "integer"
      -          },
      -          "hash_scope": {
      -            "type": "string"
      -          },
      -          "limitation": {
      -            "type": "string"
      -          },
      -          "original_result_sha256": {
      -            "type": "string"
      -          },
      -          "representation": {
      -            "const": "contract-impact-v1"
      -          },
      -          "status": {
      -            "enum": [
      -              "breaking",
      -              "review_required",
      -              "no_breaking_change_observed"
      -            ]
      -          },
      -          "used_operations": {
      -            "items": {
      -              "properties": {
      -                "method": {
      -                  "enum": [
      -                    "get",
      -                    "put",
      -                    "post",
      -                    "delete",
      -                    "options",
      -                    "head",
      -                    "patch",
      -                    "trace"
      -                  ]
      -                },
      -                "path": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "path",
      -                "method"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "counts": {
      -        "properties": {
      -          "additive": {
      -            "type": "integer"
      -          },
      -          "definitely_breaking": {
      -            "type": "integer"
      -          },
      -          "potentially_breaking": {
      -            "type": "integer"
      -          },
      -          "unclassified": {
      -            "type": "integer"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "descriptive_only": {
      -        "type": "boolean"
      -      },
      -      "fetched_at": {
      -        "type": "string"
      -      },
      -      "final_url": {
      -        "type": "string"
      -      },
      -      "hash": {
      -        "type": "string"
      -      },
      -      "openapi_versions": {
      -        "properties": {
      -          "after": {
      -            "type": "string"
      -          },
      -          "before": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "previous_hash": {
      -        "type": "string"
      -      },
      -      "reference_resolutions": {
      -        "type": "integer"
      -      },
      -      "rules_version": {
      -        "type": "integer"
      -      },
      -      "semantic_model_used": {
      -        "type": "boolean"
      -      },
      -      "source_provenance": {
      -        "properties": {
      -          "baseline_at": {
      -            "type": "string"
      -          },
      -          "baseline_url": {
      -            "type": "string"
      -          },
      -          "final_url": {
      -            "type": "string"
      -          },
      -          "raw_source_hash": {
      -            "type": "string"
      -          },
      -          "registered_core_hash": {
      -            "type": "string"
      -          },
      -          "requested_url": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "url": {
      -        "type": "string"
      -      },
      -      "warnings": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "watch_id": {
      -        "type": "string"
      -      },
      -      "work_units": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "watch_id",
      -      "hash",
      -      "previous_hash",
      -      "changed",
      -      "changes",
      -      "counts",
      -      "source_provenance",
      -      "rules_version"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Tool error only; accompanied by isError=true.",
      -    "properties": {
      -      "error": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "retryable": {
      -        "type": "boolean"
      -      },
      -      "status": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      -    "properties": {
      -      "accepts": {
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "resource": {
      -        "type": "object"
      -      },
      -      "x402Version": {
      -        "const": 2
      -      }
      -    },
      -    "required": [
      -      "x402Version",
      -      "accepts"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "not": {
      +          "required": [
      +            "input_source"
      +          ]
      +        },
      +        "required": [
      +          "watch_id"
      +        ]
      +      },
      +      {
      +        "not": {
      +          "required": [
      +            "watch_id"
      +          ]
      +        },
      +        "properties": {
      +          "input_source": {
      +            "const": "supplied_contracts"
      +          }
      +        },
      +        "required": [
      +          "input_source",
      +          "verdict",
      +          "compared_at",
      +          "source_fetches",
      +          "observation_saved"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "algorithm": {
      +        "type": "string"
      +      },
      +      "assumptions": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "changed": {
      +        "type": "boolean"
      +      },
      +      "changes": {
      +        "items": {
      +          "properties": {
      +            "after": {
      +              "type": "string"
      +            },
      +            "before": {
      +              "type": "string"
      +            },
      +            "classification": {
      +              "enum": [
      +                "definitely_breaking",
      +                "potentially_breaking",
      +                "additive",
      +                "unclassified"
      +              ]
      +            },
      +            "evidence_index": {
      +              "description": "Opt-in contract view only: index in the full original durable changes list.",
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "path": {
      +              "type": "string"
      +            },
      +            "rule": {
      +              "type": "string"
      +            },
      +            "scope": {
      +              "enum": [
      +                "selected_operation",
      +                "shared_or_unknown"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "classification",
      +            "rule",
      +            "path"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "changes_truncated": {
      +        "type": "boolean"
      +      },
      +      "compare_to": {
      +        "enum": [
      +          "previous",
      +          "baseline",
      +          "hash",
      +          "supplied"
      +        ]
      +      },
      +      "compared_at": {
      +        "type": "string"
      +      },
      +      "comparison_source": {
      +        "type": "string"
      +      },
      +      "contract_view": {
      +        "properties": {
      +          "counts_scope": {
      +            "const": "full_document"
      +          },
      +          "excluded_operation_changes": {
      +            "type": "integer"
      +          },
      +          "hash_scope": {
      +            "type": "string"
      +          },
      +          "limitation": {
      +            "type": "string"
      +          },
      +          "original_result_sha256": {
      +            "type": "string"
      +          },
      +          "representation": {
      +            "const": "contract-impact-v1"
      +          },
      +          "status": {
      +            "enum": [
      +              "breaking",
      +              "review_required",
      +              "no_breaking_change_observed"
      +            ]
      +          },
      +          "used_operations": {
      +            "items": {
      +              "properties": {
      +                "method": {
      +                  "enum": [
      +                    "get",
      +                    "put",
      +                    "post",
      +                    "delete",
      +                    "options",
      +                    "head",
      +                    "patch",
      +                    "trace"
      +                  ]
      +                },
      +                "path": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "path",
      +                "method"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "counts": {
      +        "properties": {
      +          "additive": {
      +            "type": "integer"
      +          },
      +          "definitely_breaking": {
      +            "type": "integer"
      +          },
      +          "potentially_breaking": {
      +            "type": "integer"
      +          },
      +          "unclassified": {
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "descriptive_only": {
      +        "type": "boolean"
      +      },
      +      "fetched_at": {
      +        "type": "string"
      +      },
      +      "final_url": {
      +        "type": "string"
      +      },
      +      "hash": {
      +        "type": "string"
      +      },
      +      "input_source": {
      +        "const": "supplied_contracts"
      +      },
      +      "observation_saved": {
      +        "type": "boolean"
      +      },
      +      "openapi_versions": {
      +        "properties": {
      +          "after": {
      +            "type": "string"
      +          },
      +          "before": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "previous_hash": {
      +        "type": "string"
      +      },
      +      "reference_resolutions": {
      +        "type": "integer"
      +      },
      +      "rules_version": {
      +        "type": "integer"
      +      },
      +      "semantic_model_used": {
      +        "type": "boolean"
      +      },
      +      "source_fetches": {
      +        "type": "integer"
      +      },
      +      "source_provenance": {
      +        "properties": {
      +          "after_sha256": {
      +            "type": "string"
      +          },
      +          "baseline_at": {
      +            "type": "string"
      +          },
      +          "baseline_url": {
      +            "type": "string"
      +          },
      +          "before_sha256": {
      +            "type": "string"
      +          },
      +          "final_url": {
      +            "type": "string"
      +          },
      +          "input_source": {
      +            "type": "string"
      +          },
      +          "raw_source_hash": {
      +            "type": "string"
      +          },
      +          "registered_core_hash": {
      +            "type": "string"
      +          },
      +          "requested_url": {
      +            "type": "string"
      +          },
      +          "source_authenticity": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "url": {
      +        "type": "string"
      +      },
      +      "verdict": {
      +        "properties": {
      +          "ci_exit_code": {
      +            "type": "integer"
      +          },
      +          "live_api_verified": {
      +            "type": "boolean"
      +          },
      +          "scope": {
      +            "type": "string"
      +          },
      +          "status": {
      +            "enum": [
      +              "breaking",
      +              "review_required",
      +              "no_breaking_change_observed"
      +            ]
      +          },
      +          "unsupported_features_require_review": {
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "warnings": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "watch_id": {
      +        "type": "string"
      +      },
      +      "work_units": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "hash",
      +      "previous_hash",
      +      "changed",
      +      "changes",
      +      "counts",
      +      "source_provenance",
      +      "rules_version"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Tool error only; accompanied by isError=true.",
      +    "properties": {
      +      "error": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "retryable": {
      +        "type": "boolean"
      +      },
      +      "status": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      +    "properties": {
      +      "accepts": {
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "resource": {
      +        "type": "object"
      +      },
      +      "x402Version": {
      +        "const": 2
      +      }
      +    },
      +    "required": [
      +      "x402Version",
      +      "accepts"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / compare_to / enum
      Previous value: -[
      -  "previous",
      -  "baseline",
      -  "hash"
      -]New value: +[
      +  "previous",
      +  "baseline",
      +  "hash",
      +  "supplied"
      +]
    • addedOutput schema / properties / compared_at
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / input_source
      Added value: +{
      +  "const": "supplied_contracts"
      +}
    • addedOutput schema / properties / observation_saved
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / source_fetches
      Added value: +{
      +  "type": "integer"
      +}
    • addedOutput schema / properties / source_provenance / properties / after_sha256
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / source_provenance / properties / before_sha256
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / source_provenance / properties / input_source
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / source_provenance / properties / source_authenticity
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / verdict
      Added value: +{
      +  "properties": {
      +    "ci_exit_code": {
      +      "type": "integer"
      +    },
      +    "live_api_verified": {
      +      "type": "boolean"
      +    },
      +    "scope": {
      +      "type": "string"
      +    },
      +    "status": {
      +      "enum": [
      +        "breaking",
      +        "review_required",
      +        "no_breaking_change_observed"
      +      ]
      +    },
      +    "unsupported_features_require_review": {
      +      "type": "boolean"
      +    }
      +  },
      +  "type": "object"
      +}
  5. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "algorithm": {
      +          "type": "string"
      +        },
      +        "assumptions": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "changed": {
      +          "type": "boolean"
      +        },
      +        "changes": {
      +          "items": {
      +            "properties": {
      +              "after": {
      +                "type": "string"
      +              },
      +              "before": {
      +                "type": "string"
      +              },
      +              "classification": {
      +                "enum": [
      +                  "definitely_breaking",
      +                  "potentially_breaking",
      +                  "additive",
      +                  "unclassified"
      +                ]
      +              },
      +              "evidence_index": {
      +                "description": "Opt-in contract view only: index in the full original durable changes list.",
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "path": {
      +                "type": "string"
      +              },
      +              "rule": {
      +                "type": "string"
      +              },
      +              "scope": {
      +                "enum": [
      +                  "selected_operation",
      +                  "shared_or_unknown"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "classification",
      +              "rule",
      +              "path"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "changes_truncated": {
      +          "type": "boolean"
      +        },
      +        "compare_to": {
      +          "enum": [
      +            "previous",
      +            "baseline",
      +            "hash"
      +          ]
      +        },
      +        "comparison_source": {
      +          "type": "string"
      +        },
      +        "contract_view": {
      +          "properties": {
      +            "counts_scope": {
      +              "const": "full_document"
      +            },
      +            "excluded_operation_changes": {
      +              "type": "integer"
      +            },
      +            "hash_scope": {
      +              "type": "string"
      +            },
      +            "limitation": {
      +              "type": "string"
      +            },
      +            "original_result_sha256": {
      +              "type": "string"
      +            },
      +            "representation": {
      +              "const": "contract-impact-v1"
      +            },
      +            "status": {
      +              "enum": [
      +                "breaking",
      +                "review_required",
      +                "no_breaking_change_observed"
      +              ]
      +            },
      +            "used_operations": {
      +              "items": {
      +                "properties": {
      +                  "method": {
      +                    "enum": [
      +                      "get",
      +                      "put",
      +                      "post",
      +                      "delete",
      +                      "options",
      +                      "head",
      +                      "patch",
      +                      "trace"
      +                    ]
      +                  },
      +                  "path": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "path",
      +                  "method"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "counts": {
      +          "properties": {
      +            "additive": {
      +              "type": "integer"
      +            },
      +            "definitely_breaking": {
      +              "type": "integer"
      +            },
      +            "potentially_breaking": {
      +              "type": "integer"
      +            },
      +            "unclassified": {
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "descriptive_only": {
      +          "type": "boolean"
      +        },
      +        "fetched_at": {
      +          "type": "string"
      +        },
      +        "final_url": {
      +          "type": "string"
      +        },
      +        "hash": {
      +          "type": "string"
      +        },
      +        "openapi_versions": {
      +          "properties": {
      +            "after": {
      +              "type": "string"
      +            },
      +            "before": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "previous_hash": {
      +          "type": "string"
      +        },
      +        "reference_resolutions": {
      +          "type": "integer"
      +        },
      +        "rules_version": {
      +          "type": "integer"
      +        },
      +        "semantic_model_used": {
      +          "type": "boolean"
      +        },
      +        "source_provenance": {
      +          "properties": {
      +            "baseline_at": {
      +              "type": "string"
      +            },
      +            "baseline_url": {
      +              "type": "string"
      +            },
      +            "final_url": {
      +              "type": "string"
      +            },
      +            "raw_source_hash": {
      +              "type": "string"
      +            },
      +            "registered_core_hash": {
      +              "type": "string"
      +            },
      +            "requested_url": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "url": {
      +          "type": "string"
      +        },
      +        "warnings": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "watch_id": {
      +          "type": "string"
      +        },
      +        "work_units": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "watch_id",
      +        "hash",
      +        "previous_hash",
      +        "changed",
      +        "changes",
      +        "counts",
      +        "source_provenance",
      +        "rules_version"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "description": "Tool error only; accompanied by isError=true.",
      +      "properties": {
      +        "error": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "retryable": {
      +          "type": "boolean"
      +        },
      +        "status": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      +      "properties": {
      +        "accepts": {
      +          "minItems": 1,
      +          "type": "array"
      +        },
      +        "resource": {
      +          "type": "object"
      +        },
      +        "x402Version": {
      +          "const": 2
      +        }
      +      },
      +      "required": [
      +        "x402Version",
      +        "accepts"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.",
      +  "properties": {
      +    "algorithm": {
      +      "type": "string"
      +    },
      +    "assumptions": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "changed": {
      +      "type": "boolean"
      +    },
      +    "changes": {
      +      "items": {
      +        "properties": {
      +          "after": {
      +            "type": "string"
      +          },
      +          "before": {
      +            "type": "string"
      +          },
      +          "classification": {
      +            "enum": [
      +              "definitely_breaking",
      +              "potentially_breaking",
      +              "additive",
      +              "unclassified"
      +            ]
      +          },
      +          "evidence_index": {
      +            "description": "Opt-in contract view only: index in the full original durable changes list.",
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "path": {
      +            "type": "string"
      +          },
      +          "rule": {
      +            "type": "string"
      +          },
      +          "scope": {
      +            "enum": [
      +              "selected_operation",
      +              "shared_or_unknown"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "classification",
      +          "rule",
      +          "path"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "changes_truncated": {
      +      "type": "boolean"
      +    },
      +    "compare_to": {
      +      "enum": [
      +        "previous",
      +        "baseline",
      +        "hash"
      +      ]
      +    },
      +    "comparison_source": {
      +      "type": "string"
      +    },
      +    "contract_view": {
      +      "properties": {
      +        "counts_scope": {
      +          "const": "full_document"
      +        },
      +        "excluded_operation_changes": {
      +          "type": "integer"
      +        },
      +        "hash_scope": {
      +          "type": "string"
      +        },
      +        "limitation": {
      +          "type": "string"
      +        },
      +        "original_result_sha256": {
      +          "type": "string"
      +        },
      +        "representation": {
      +          "const": "contract-impact-v1"
      +        },
      +        "status": {
      +          "enum": [
      +            "breaking",
      +            "review_required",
      +            "no_breaking_change_observed"
      +          ]
      +        },
      +        "used_operations": {
      +          "items": {
      +            "properties": {
      +              "method": {
      +                "enum": [
      +                  "get",
      +                  "put",
      +                  "post",
      +                  "delete",
      +                  "options",
      +                  "head",
      +                  "patch",
      +                  "trace"
      +                ]
      +              },
      +              "path": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "path",
      +              "method"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "counts": {
      +      "properties": {
      +        "additive": {
      +          "type": "integer"
      +        },
      +        "definitely_breaking": {
      +          "type": "integer"
      +        },
      +        "potentially_breaking": {
      +          "type": "integer"
      +        },
      +        "unclassified": {
      +          "type": "integer"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "descriptive_only": {
      +      "type": "boolean"
      +    },
      +    "fetched_at": {
      +      "type": "string"
      +    },
      +    "final_url": {
      +      "type": "string"
      +    },
      +    "hash": {
      +      "type": "string"
      +    },
      +    "openapi_versions": {
      +      "properties": {
      +        "after": {
      +          "type": "string"
      +        },
      +        "before": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "previous_hash": {
      +      "type": "string"
      +    },
      +    "reference_resolutions": {
      +      "type": "integer"
      +    },
      +    "rules_version": {
      +      "type": "integer"
      +    },
      +    "semantic_model_used": {
      +      "type": "boolean"
      +    },
      +    "source_provenance": {
      +      "properties": {
      +        "baseline_at": {
      +          "type": "string"
      +        },
      +        "baseline_url": {
      +          "type": "string"
      +        },
      +        "final_url": {
      +          "type": "string"
      +        },
      +        "raw_source_hash": {
      +          "type": "string"
      +        },
      +        "registered_core_hash": {
      +          "type": "string"
      +        },
      +        "requested_url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "url": {
      +      "type": "string"
      +    },
      +    "warnings": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "watch_id": {
      +      "type": "string"
      +    },
      +    "work_units": {
      +      "type": "integer"
      +    }
      +  },
      +  "type": "object"
      +}
  6. Changed4 schema fields changed
    • addedInput schema / description
      Added value: +"Compare a registered, unfiltered public JSON OpenAPI 3.0/3.1 contract; watch_id is required, compare_to defaults to previous, and optional previous_hash overrides it. Bounded structural analysis, not a complete compatibility proof; no YAML, external reference fetching or execution of described API operations. Unknown fields are rejected."
    • addedInput schema / properties / compare_to / description
      Added value: +"Optional mode: 'previous' (default) compares with the latest saved OpenAPI Contract Diff snapshot; 'baseline' uses its fixed saved baseline. Before contract history exists, the current registered watch state seeds the initial baseline. previous_hash overrides the mode. 'hash' appears only in results, not as an accepted input mode."
    • addedInput schema / properties / previous_hash / description
      Added value: +"Optional 64-character hexadecimal reference hash, case-insensitive. Prefer a hash returned by OpenAPI Contract Diff for this same watch, matching a retained contract snapshot or fixed baseline. The current registered core hash is also accepted as a fallback: without a matching contract snapshot, the fixed baseline (or registered state if no baseline exists) is used. Overrides compare_to; unavailable hashes return 404. Omit to use the selected mode."
    • addedInput schema / properties / watch_id / description
      Added value: +"Required existing watch ID: 'w_' plus 32 lowercase hexadecimal characters. Obtain it with free fresh402_register or POST /v1/register using the public JSON OpenAPI 3.0/3.1 URL and no selector or ignore rules. Reuses the saved URL; do not pass url here. YAML, non-OpenAPI documents and scoped/filtered watches are unsupported. Illustrative IDs must be replaced."
  7. Added

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations declare a non-read-only, open-world, non-idempotent, potentially destructive operation; the description adds that execution can charge USDC or prepaid credits, consume trial quota, update Fresh402 records, return an unpaid quote without credentials, and require spending authorization. It also discloses recovery expectations, idempotency requirements, 429 eligibility behavior, no auto-pay, and network-selection constraints beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The definition is a single dense paragraph that mixes purpose, billing, trial quota, MPP, Circle/Solana payment routing, recovery, and limitations, with the core comparison purpose not front-loaded. It also repeats persistence/recovery instructions and payment cautions, making it hard to scan despite the relevance of much of the content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a paid, multi-network, schema-rich tool with an output schema, the description covers authorization, payment paths, unpaid quote behavior, trial limits, recovery, supported inputs, and explicit non-goals. An agent has enough context to decide whether to call it and how to handle payment and error states.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description still adds operational meaning by explaining watch_id acquisition via free Register, exclusivity with contracts, supplied-pair no-fetch behavior, and when to omit compare_to or previous_hash. Much of this is duplicated in the schema's own rich parameter descriptions, so it does not reach the highest level.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the resource (OpenAPI 3.0/3.1 contracts) and the operation (directional before/after contract-change evidence), and distinguishes stored-watch mode from explicit supplied pairs. However, the first sentence is a generic 'Observes public documents' statement, so the actual diff purpose is buried rather than front-loaded.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly states to use exactly one real watch_id from free registration or contracts:{before,after}, to omit overrides in supplied mode, and to use API Compatibility Review for a complete single-charge workflow when advertised. It also names exclusions such as no YAML watch sources, no external-reference fetch, no endpoint execution, and explains previous/baseline/hash selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources