oasdiff

Issues somebody may already be working on are listed last. List everything by date

• Changing the `type` of a security scheme in use (apiKey → http bearer) is reported at info

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 Half a day Newbie friendliness 68/100

  oasdiff/oasdiff#1284 · Opened Oct 7, 2026

  Maintainers usually reply within 1 day

• Securing an anonymous operation is info, while making a secured operation anonymous is an error

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 75/100

  oasdiff/oasdiff#1283 · Opened Oct 7, 2026

  Maintainers usually reply within 1 day

• Removing an `enum` constraint entirely is reported as each value removed (false error on requests, missed break on responses)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 72/100

  oasdiff/oasdiff#1280 · Opened Oct 7, 2026

  Maintainers usually reply within 1 day

• checker: object parameter properties are only checked for headers (became-enum, became-required, new required property)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 74/100

  oasdiff/oasdiff#1277 · Opened Oct 6, 2026

  Maintainers usually reply within 1 day

• checker: deprecation and media type details are not localized

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 Half a day Newbie friendliness 72/100

  oasdiff/oasdiff#1276 · Opened Oct 5, 2026

  Maintainers usually reply within 1 day

• changelog: report the location of each element a change names

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  Difficulty 4/5 3-5 days Newbie friendliness 52/100

  oasdiff/oasdiff#1266 · Opened Oct 4, 2026

  Maintainers usually reply within 1 day

• flatten: an explicit empty enum is dropped when merging allOf

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 Half a day Newbie friendliness 82/100

  oasdiff/oasdiff#1262 · Opened Sep 17, 2026

  Maintainers usually reply within 1 day

• flatten: one unmergeable property aborts the whole document

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 72/100

  oasdiff/oasdiff#1261 · 2 comments · Opened Sep 17, 2026

  Maintainers usually reply within 1 day

• diff, changelog and breaking overflow the stack on a spec with a callback cycle

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 72/100

  oasdiff/oasdiff#1257 · Opened Sep 16, 2026

  Maintainers usually reply within 1 day

• changelog: group a change reached through many paths into one entry per operation

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 55/100

  oasdiff/oasdiff#1256 · 1 comment · Opened Sep 15, 2026

  Maintainers usually reply within 1 day

• Define the review and annotation experience for transformed comparisons (--flatten-allof and friends)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 5/5 Over a week Newbie friendliness 20/100

  oasdiff/oasdiff#1247 · Opened Sep 13, 2026

  Maintainers usually reply within 1 day

• flatten: replace redirectSchemaRefs reflection with kin's SchemaRef.WalkSubtree

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  oasdiff/oasdiff#1239 · 1 comment · Opened Sep 11, 2026

  Maintainers usually reply within 1 day

• prefixItems: carry the non-equivalence witness from the diff to the message and verdict

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 48/100

  oasdiff/oasdiff#1201 · Opened Aug 30, 2026

  Maintainers usually reply within 1 day

• Degenerate boolean schemas misreport at every schema-slot existence check, not only media types

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 57/100

  oasdiff/oasdiff#1199 · Opened Aug 30, 2026

  Maintainers usually reply within 1 day

• itemSchema existence changes do not classify the degenerate schemas

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 68/100

  oasdiff/oasdiff#1196 · Opened Aug 30, 2026

  Maintainers usually reply within 1 day

• validate: cross-check minItems and maxItems against the prefixItems length

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 68/100

  oasdiff/oasdiff#1181 · Opened Aug 25, 2026

  Maintainers usually reply within 1 day

• checker: security scheme wire fields (apiKey name/in, http scheme, openIdConnectUrl) are not checked

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 70/100

  oasdiff/oasdiff#1175 · Opened Aug 20, 2026

  Maintainers usually reply within 1 day

• checker: media type itemSchema is only checked for existence (OpenAPI 3.2)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 68/100

  oasdiff/oasdiff#1167 · Opened Aug 16, 2026

  Maintainers usually reply within 1 day

• checker: parameters using the content form are not checked

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 62/100

  oasdiff/oasdiff#1166 · Opened Aug 16, 2026

  Maintainers usually reply within 1 day

• checker: multipart and form encoding metadata is not checked

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 68/100

  oasdiff/oasdiff#1165 · Opened Aug 16, 2026

  Maintainers usually reply within 1 day

• checker: parameter serialization keywords (style, explode, allowReserved) are not checked

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 67/100

  oasdiff/oasdiff#1164 · Opened Aug 16, 2026

  Maintainers usually reply within 1 day

• checker: path-level parameter modifications and removals are not checked

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 68/100

  oasdiff/oasdiff#1163 · Opened Aug 16, 2026

  Maintainers usually reply within 1 day

• checker: response header schemas are only checked for type, format, and nullable

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 62/100

  oasdiff/oasdiff#1162 · Opened Aug 16, 2026

  Maintainers usually reply within 1 day

• checker: callbacks are not checked

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 1-2 days Newbie friendliness 68/100

  oasdiff/oasdiff#1161 · Opened Aug 16, 2026

  Maintainers usually reply within 1 day

• checker: changes inside webhook operations are not checked

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 52/100

  oasdiff/oasdiff#1160 · Opened Aug 16, 2026

  Maintainers usually reply within 1 day

• Add x-stability-level and x-sunset to OpenAPI extension registry

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 3/5 Half a day Newbie friendliness 48/100

  oasdiff/oasdiff#1148 · 1 comment · Opened Aug 13, 2026

  Maintainers usually reply within 1 day

• Support source locations (line and column) for specs in JSON format

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  Difficulty 3/5 1-2 days Newbie friendliness 66/100

  oasdiff/oasdiff#1128 · 2 reactions · Opened Jul 27, 2026

  Maintainers usually reply within 1 day

• Response header schema checks: remaining slices

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 48/100

  oasdiff/oasdiff#1117 · 1 comment · Opened Jul 24, 2026

  Maintainers usually reply within 1 day

• checker: classify a sub-schema added or removed (items, additionalProperties, not, ...), follow-up to #1050

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#1054 · 1 comment · Opened Jun 27, 2026

  Maintainers usually reply within 1 day

• checker: report single->oneOf wrapping accurately (keep the breaking verdict, fix the message), supersedes #1022

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#1037 · 2 comments · Opened Jun 22, 2026

  Maintainers usually reply within 1 day

• checker: response property type/pattern changes lack generalize/specialize granularity

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#1034 · 1 comment · Opened Jun 21, 2026

  Maintainers usually reply within 1 day

• cli: --stability-level filtering is operation-granular only (below-threshold properties not filtered)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#1030 · Opened Jun 21, 2026

  Maintainers usually reply within 1 day

• validate: flag invalid x-stability-level values (move out of breaking/changelog)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#1029 · 1 comment · Opened Jun 21, 2026

  Maintainers usually reply within 1 day

• cli: slice flags split values on commas (a value containing a comma can't be represented)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#1027 · Opened Jun 20, 2026

  Maintainers usually reply within 1 day

• cli: remove the fixViperStringSlice workaround

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#1026 · Opened Jun 20, 2026

  Maintainers usually reply within 1 day

• checker: pattern_added_or_changed has no body-level rules

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#950 · Opened May 27, 2026

  Maintainers usually reply within 1 day

• validate: [tracking] hard-rules spec-compliance subcommand

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#927 · 2 comments · Opened May 12, 2026

  Maintainers usually reply within 1 day

• checker: [3.1] add formatMinimum/formatMaximum diff and breaking-change rules

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#925 · 2 comments · Opened May 12, 2026

  Maintainers usually reply within 1 day

• checker: changelog messages should describe semantic impact, not syntactic dialect shape

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#924 · Opened May 11, 2026

  Maintainers usually reply within 1 day

• flatten: replace the allOf field-allowlist with a per-field registry

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#886 · Opened May 4, 2026

  Maintainers usually reply within 1 day

• flatten: allOf silently drops 3.1-specific schema keywords

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  oasdiff/oasdiff#878 · Opened May 3, 2026

  Maintainers usually reply within 1 day

• chore: split combined parameter+property checker functions into separate single-scope functions

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  oasdiff/oasdiff#866 · 1 comment · Opened Apr 24, 2026

  Maintainers usually reply within 1 day

• checker: support property-level sunset lifecycle (deprecate, sunset, remove)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#858 · 2 comments · Opened Apr 22, 2026

  Maintainers usually reply within 1 day

• checker: apply mime-type name matching to requests

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#700 · Opened May 1, 2025

  Maintainers usually reply within 1 day

• build: split the repo into a go module and the oasdiff executable

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  tech-debt

  oasdiff/oasdiff#618 · Opened Oct 7, 2024

  Maintainers usually reply within 1 day

• checker: handle default values properly

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  oasdiff/oasdiff#555 · Opened Jun 5, 2024

  Maintainers usually reply within 1 day

• checker: support breaking-changes and changelog for multi-type schemas

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  oasdiff/oasdiff#534 · Opened Apr 30, 2024

  Maintainers usually reply within 1 day

• feat: support external metadata

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  oasdiff/oasdiff#494 · 1 comment · Opened Feb 21, 2024

  Maintainers usually reply within 1 day

• feat: visual comparison of example diffs (diff tool)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  oasdiff/oasdiff#404 · 3 comments · Opened Oct 24, 2023

  Maintainers usually reply within 1 day

• output: add more detail to text/markdown output

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  enhancement

  oasdiff/oasdiff#390 · 1 comment · Opened Sep 28, 2023

  Maintainers usually reply within 1 day