feat: Improve OpenAPI compatibility for real-world specs

[kevin-krause]

[kevin-krause]

still needs some clean up seems like some files were commited by mistake, I will push the fix bf we can move this from draft to pr

[lucianfialho]

Revisei isso hoje, com atraso — desculpa por ter demorado.

O trabalho é bom e o comentário que você deixou dizendo que precisava de limpeza já estava desatualizado no mesmo dia: o branch é um commit único, sem arquivos soltos, build limpo e 129 testes passando. Não havia nada pendente da sua parte.

Reproduzi o bug principal e ele é pior do que o título sugere. Dois operationId que colapsam no mesmo nome não degradam um comando — o Commander lança durante a construção da árvore, então toda invocação morre, inclusive --help:

$ spec2cli --spec api.json items --help
Error: cannot add command 'search' as already have command 'search'

Rebaseei seu trabalho em main e abri como #31, com você como co-autor. Duas coisas mudaram:

1. Deixei de fora a metade de refactor (url.ts, http.ts, dry-run.ts). Ela colide com Adaptive --agent-help, machine-readable failures, and the bench behind both #29, que faz a mesma extração. Seu fix do fragmento # na URL não estava coberto por nada, então foi portado junto do Adaptive --agent-help, machine-readable failures, and the bench behind both #29 — também com sua co-autoria.
2. Enquanto o PR esperava, parte dele foi reimplementada em main de forma independente e mais fraca (resolveParameter sem escape de JSON Pointer). Survive specs whose operation and parameter names collide #31 melhora essa versão em vez de reintroduzir a sua.

Adicionei testes de regressão e verifiquei que falham em main antes de passarem — 5 pegam bugs reais, 4 são guardas do comportamento que já funcionava.

Fechando aqui em favor do #31. Obrigado pela contribuição, e desculpa de novo pelo tempo que levou.