0.36.6 - 2026-10-20

Full Changelog: v0.36.5...v0.36.6

15 commits in this release.

Documentation

• doc: updated contributors file by @bot-go-openapi[bot] in #153 ...

Testing

• test: fix test error on go1.27 by @fredbi in #167 ...

Miscellaneous tasks

• chore: prepare release v0.36.6 by @bot-go-openapi[bot] in #168 ...

Updates

• chore(deps): Bump the golang-org-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #163 ...
• chore(deps): Bump github.com/knadh/koanf/v2 from 2.3.7 to 2.3.8 in the other-dependencies group across 1 directory by @dependabot[bot] in #165 ...
• chore(deps): Bump the playground-dependencies group across 1 directory with 3 updates by @dependabot[bot] in #166 ...
• chore(deps-dev): Bump the development-dependencies group in /hack/doc-site/genspec-wasi with 2 updates by @dependabot[bot] in #164 ...
• chore(deps): Bump the development-dependencies group across 1 directory with 13 updates by @dependabot[bot] in #162 ...
• chore(deps): Bump golang.org/x/tools from 0.50.0 to 0.51.0 in the golang-org-dependencies group across 1 directory by @dependabot[bot] in #158 ...
• chore(deps): Bump the go-openapi-dependencies group across 5 directories with 2 updates by @dependabot[bot] in #159 ...
• chore(deps): Bump swagger-ui-dist from 5.33.0 to 5.33.1 in /hack/doc-site/genspec-wasi in the playground-dependencies group across 1 directory by @dependabot[bot] in #161 ...
• chore(deps-dev): Bump the development-dependencies group in /hack/doc-site/genspec-wasi with 2 updates by @dependabot[bot] in #160 ...
• chore(deps): Bump github.com/knadh/koanf/v2 from 2.3.6 to 2.3.7 in the other-dependencies group across 1 directory by @dependabot[bot] in #154 ...
• chore(deps): Bump the playground-dependencies group across 1 directory with 3 updates by @dependabot[bot] in #156 ...
• chore(deps-dev): Bump the development-dependencies group in /hack/doc-site/genspec-wasi with 2 updates by @dependabot[bot] in #155 ...

People who contributed to this release

• @fredbi

codescan license terms

Per-module changes

cmd/genspec-tui (0.36.6)

Testing

• test: fix test error on go1.27 by @fredbi in #167 ...

Miscellaneous tasks

• chore: prepare release v0.36.6 by @bot-go-openapi[bot] in #168 ...

Updates

• chore(deps): Bump golang.org/x/tools from 0.50.0 to 0.51.0 in the golang-org-dependencies group across 1 directory by @dependabot[bot] in #158 ...
• chore(deps): Bump the go-openapi-dependencies group across 5 directories with 2 updates by @dependabot[bot] in #159 ...

cmd/genspec (0.36.6)

Testing

• test: fix test error on go1.27 by @fredbi in #167 ...

Miscellaneous tasks

• chore: prepare release v0.36.6 by @bot-go-openapi[bot] in #168 ...

Updates

• chore(deps): Bump the golang-org-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #163 ...
• chore(deps): Bump github.com/knadh/koanf/v2 from 2.3.7 to 2.3.8 in the other-dependencies group across 1 directory by @dependabot[bot] in #165 ...
• chore(deps): Bump golang.org/x/tools from 0.50.0 to 0.51.0 in the golang-org-dependencies group across 1 directory by @dependabot[bot] in #158 ...
• chore(deps): Bump the go-openapi-dependencies group across 5 directories with 2 updates by @dependabot[bot] in #159 ...
• chore(deps): Bump github.com/knadh/koanf/v2 from 2.3.6 to 2.3.7 in the other-dependencies group across 1 directory by @dependabot[bot] in #154 ...

docs/examples (0.36.6)

Testing

• test: fix test error on go1.27 by @fredbi in #167 ...

Miscellaneous tasks

• chore: prepare release v0.36.6 by @bot-go-openapi[bot] in #168 ...

Updates

• chore(deps): Bump the golang-org-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #163 ...
• chore(deps): Bump golang.org/x/tools from 0.50.0 to 0.51.0 in the golang-org-dependencies group across 1 directory by @dependabot[bot] in #158 ...
• chore(deps): Bump the go-openapi-dependencies group across 5 directories with 2 updates by [@dependabot[bot]](https://...

0.36.5 - 2026-09-25

Full Changelog: v0.36.4...v0.36.5

20 commits in this release.

Documentation

• doc: updated contributors file by @bot-go-openapi[bot] in #138 ...
• ci: monitor bot pr is now scheduled 3 times a day by @fredbi ...
• doc: advertised doc site on README by @fredbi ...

Miscellaneous tasks

• chore: prepare release v0.36.5 by @bot-go-openapi[bot] in #151 ...
• chore: upgrade go1.26 by @fredbi in #143 ...
• chore(dependabot): fix invalid timezone by @fredbi ...

Updates

• chore(deps-dev): Bump svelte from 5.57.0 to 5.57.1 in /hack/doc-site/genspec-wasi in the development-dependencies group by @dependabot[bot] in #152 ...
• chore(deps): Bump the playground-dependencies group across 1 directory with 4 updates by @dependabot[bot] in #150 ...
• chore(deps): Bump the go-openapi-dependencies group across 4 directories with 6 updates by @dependabot[bot] in #145 ...
• chore(deps): Bump the golang-org-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #148 ...
• chore(deps-dev): Bump the development-dependencies group in /hack/doc-site/genspec-wasi with 2 updates by @dependabot[bot] in #149 ...
• chore(deps): Bump the development-dependencies group with 10 updates by @dependabot[bot] in #146 ...
• chore(deps): Bump the playground-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #142 ...
• chore(deps): Bump actions/deploy-pages from 5.0.0 to 5.0.1 in the development-dependencies group across 1 directory by @dependabot[bot] in #140 ...
• chore(deps-dev): Bump the development-dependencies group in /hack/doc-site/genspec-wasi with 2 updates by @dependabot[bot] in #141 ...
• chore(deps): Bump the go-openapi-dependencies group across 5 directories with 8 updates by @dependabot[bot] in #137 ...
• chore(deps): Bump the development-dependencies group with 10 updates by @dependabot[bot] in #135 ...
• chore(deps-dev): Bump the development-dependencies group in /hack/doc-site/genspec-wasi with 3 updates by @dependabot[bot] in #134 ...

Other (technical)

• ci: monitor bot pr is now scheduled 3 times a day by @fredbi in #133 ...
• doc: advertised doc site on README by @fredbi in #132 ...

People who contributed to this release

• @fredbi

codescan license terms

Per-module changes

cmd/genspec-tui (0.36.5)

Miscellaneous tasks

• chore: prepare release v0.36.5 by @bot-go-openapi[bot] in #151 ...
• chore: upgrade go1.26 by @fredbi in #143 ...

Updates

• chore(deps): Bump the go-openapi-dependencies group across 4 directories with 6 updates by @dependabot[bot] in #145 ...
• chore(deps): Bump the golang-org-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #148 ...
• chore(deps): Bump the go-openapi-dependencies group across 5 directories with 8 updates by @dependabot[bot] in #137 ...

cmd/genspec (0.36.5)

Miscellaneous tasks

• chore: prepare release v0.36.5 by @bot-go-openapi[bot] in #151 ...
• chore: upgrade go1.26 by @fredbi in #143 ...

Updates

• chore(deps): Bump the go-openapi-dependencies group across 4 directories with 6 updates by @dependabot[bot] in #145 ...
• chore(deps): Bump the golang-org-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #148 ...
• chore(deps): Bump the go-openapi-dependencies group across 5 directories with 8 updates by @dependabot[bot] in #137 ...

docs/examples (0.36.5)

Miscellaneous tasks

• chore: prepare release v0.36.5 by @bot-go-openapi[bot] in #151 ...
• chore: upgrade go1.26 by @fredbi in #143 ...

Updates

• chore(deps): Bump the go-openapi-dependencies group across 4 directories with 6 updates by @dependabot[bot] in #145 ...
• chore(deps): Bump the golang-org-dependencies group across 1 d...

0.36.4 - 2026-08-21

Full Changelog: v0.36.3...v0.36.4

151 commits in this release.

Implemented enhancements

• feat(genspec-tui): charge the CPU table where a reader can act on it by @fredbi ...
• feat(genspec-tui): share the CLI's flags and configuration file by @fredbi ...
• feat(cliconf): add -c and -no-config to pin or refuse the file by @fredbi ...
• feat(genspec): read a configuration file before the flags by @fredbi ...
• feat(genspec-tui): profile a scan and name where its cost went by @fredbi ...
• feat(genspec-tui): locate every validation finding exactly by @fredbi ...
• feat(genspec-tui): navigate a finding about the whole document by @fredbi ...
• feat(genspec-tui): take a finding's location from the validator by @fredbi ...
• feat(scanner): take dependency types from the build cache by default by @fredbi ...
• feat(schema): recognize the math/big numbers by what they marshal to by @fredbi ...
• feat(genspec-tui): validate the generated spec in a tab of its own by @fredbi ...
• feat(genspec-tui): look up an annotation without leaving the file by @fredbi ...
• feat(genspec-tui): make the pane dividers movable by @fredbi ...
• feat(genspec-tui): add a guarded F5 reload of the open file by @fredbi ...
• feat(genspec-wasi): add a headless spec generator needing no toolchain by @fredbi ...
• feat(scanner): take dependency types from compiled export data by @fredbi ...
• feat(scanner): load and type-check packages without a Go toolchain by @fredbi ...

Fixed bugs

• fix(builders): match json.RawMessage through its go1.27 jsontext alias by @fredbi ...
• fix(cliopts): keep the path options off the configuration file by @fredbi ...
• fix(packages): resolve the standard library's own vendored imports by @fredbi ...
• fix(scanner): read swagger:meta from the comment it was written in by @fredbi ...
• fix(genspec-tui): show control characters instead of obeying them by @fredbi ...
• fix(benchmarks): judge archive entry names in tar form, not the host's by @fredbi ...
• fix(genspec-tui): keep two path segments in a profiled function name by @fredbi ...
• fix(cmd): give each scan its own copy of the options by @fredbi ...
• fix(probe): build the browser probe's status line as text by @fredbi ...
• fix(doc-site): move vendored Mermaid to 11.16.1 by @fredbi ...
• fix(genspec-tui): show the validator's warnings by @fredbi ...
• fix(scanner): match a dependency's source file by name, not by path by @fredbi ...
• fix(scanner): read a dependency's declaration when the spec needs it by @fredbi ...
• fix(schema): give every non-body parameter and header a type by @fredbi ...
• fix(responses): give a response declared on a stdlib type its schema by @fredbi ...
• fix(genspec-tui): say how much of the keymap is off screen by @fredbi ...
• fix(genspec-tui): keep the whole header on screen under a long work dir by @fredbi ...
• fix(genspec-tui): stop the scrolling popups resizing as they scroll by @fredbi ...
• fix(genspec-wasi): resolve -workdir the way the host writes paths by @fredbi ...
• fix(packages): read paths the way the host writes them by @fredbi ...
• fix(builders): don't fail a scan over a declaration that cannot be read by @fredbi ...
• fix(packages): read back a dependency's annotated source by @fredbi ...
• refact(builders): resolve a written type without the expression map by @fredbi ...
• fix(resolvers): added new runtime streamed type to auto-detected file type by @fredbi in #89 ...

Refactor

• refact: reorganized command line options handling by @fredbi ...
• refact(genspec-wasi): declare every scan option once, in one table by @fredbi ...
• refact(scanner): make a declaration's absent source impossible to ignore by @fredbi ...
• refact(scanner): answer a declaration's name and position from its type by @fredbi ...
• refact(parsers): read the annotation line instead of matching it by @fredbi ...

Documentation

• test(integration): refresh TestStdlibUUID's stale embed expectation by @fredbi ...
• doc: rules for technical writing by @fredbi in #126 [...](162d59530a...

0.36.3 - 2026-08-05

Full Changelog: v0.36.2...v0.36.3

42 commits in this release.

Implemented enhancements

• feat(schema): recognize stdlib stream types as opaque bytes by @fredbi ...
• feat(schema): report a classifier annotation on an embed as ineffective by @fredbi ...
• feat(scanner): report a path annotation that does not parse by @fredbi ...

Fixed bugs

• fix(schema): report a dropped description on a $ref'd field by @fredbi ...
• fix(schema): record the Go type behind a recognized byte stream by @fredbi ...
• fix(schema): emit a property for an embed that promotes nothing by @fredbi ...
• fix(schema): stop reporting a json-named embed's classifier as ignored by @fredbi ...
• fix(schema): run the classifier cascade on an allOf member by @fredbi ...
• fix(parsers): accept a one-character tag or operationId in a route by @fredbi ...
• fix(responses): write a body's vendor extensions into its schema by @fredbi ...
• fix(builders): run the canonical stdlib recognizers in the field arms by @fredbi ...
• fix(responses): follow a declaration's written right-hand side, not its underlying by @fredbi ...
• fix(responses): attach the schema a named non-struct response builds by @fredbi ...
• fix(builders): let the field dispatch reach the element-aware format rule by @fredbi ...
• fix(parameters): drop an error-typed parameter instead of failing the scan by @fredbi ...
• fix(schema): honour an alias declaration in body positions, and detect the next drift by @fredbi ...
• fix(schema): report a swagger:enum an alias can never host by @fredbi ...
• fix(grammar): stop rejecting in: and name: beside a classifier annotation by @fredbi ...
• fix(schema): honour swagger:type on an alias, and accept file where OAS 2.0 does by @fredbi ...
• fix(schema): emit the properties encoding/json actually marshals by @fredbi ...
• fix(schema): decide a sequence's strfmt placement by its element type by @fredbi ...
• fix(schema): honour swagger:strfmt on an alias declaration by @fredbi ...

Refactor

• chore(genspec-tui): refactor TUI by @fredbi in #82 ...
• refact(builders): share the schema sub-build the field dispatch repeats by @fredbi ...
• refact(builders): share one alias-field resolution across parameters and responses by @fredbi ...

Documentation

• test: cover the code paths the suite never entered by @fredbi in #84 ...
• doc: document byte streams and the marshaller allOf composition needs by @fredbi ...
• doc: say that a classifier annotation on an embed is ignored by @fredbi ...
• fix(scanner): skip an unrecognised annotation instead of failing the scan by @fredbi ...

Code quality

• chore(quality): revise the source comments by @fredbi in #83 ...

Testing

• test(builders): compare an allOf member against the other full-schema positions by @fredbi ...
• test(builders): cover the field-dispatch arms and the response items anchor by @fredbi ...
• test(schema): map swagger:strfmt handling across every alias dispatch site by @fredbi ...

Miscellaneous tasks

• chore: prepare release v0.36.3 by @bot-go-openapi[bot] in #87 ...
• chore: configure coverage & quality rating tools by @fredbi in #86 ...
• chore(spec): record what the prose walk can never reach by @fredbi ...
• fix(schema): report values that cannot be read as their schema type by @fredbi ...
• fix(schema): type default, example and enum values on a declaration by @fredbi ...
• fix(schema): retire swagger:default, which never emitted a default by @fredbi ...

Other (technical)

• Fix/coverage quirks by @fredbi in #85 ...
• Fix/more quirks by @fredbi in #81 ...
• Fix/strfmt dispatch symmetry by @fredbi in #80 ...

People who contributed to this release

• @fredbi

codescan license terms

Per-module changes

cmd/genspec-tui (0.36.3)

Fixed bugs

• fix(grammar): stop rejecting in: and name: beside a classifier annotation by @fredbi ...

Refactor

• chore(genspec-t...

0.36.2 - 2026-08-01

Enhanced support for enums from const

Full Changelog: v0.36.1...v0.36.2

5 commits in this release.

Implemented enhancements

• feat(schema): recognize the go1.27 standard-library uuid.UUID by @fredbi ...

Documentation

• docs(doc-site): explain how UUID types are recognized by @fredbi ...

Miscellaneous tasks

• chore: prepare release v0.36.2 by @bot-go-openapi[bot] in #78 ...
• ci: fix mono-repo release for installable packages by @fredbi ...

Other (technical)

• Stdlib UUID (go1.27) by @fredbi in #77 ...

People who contributed to this release

• @fredbi

codescan license terms

Per-module changes

cmd/genspec-tui (0.36.2)

Miscellaneous tasks

• chore: prepare release v0.36.2 by @bot-go-openapi[bot] in #78 ...

docs/examples (0.36.2)

Miscellaneous tasks

• chore: prepare release v0.36.2 by @bot-go-openapi[bot] in #78 ...

fixtures (0.36.2)

Implemented enhancements

• feat(schema): recognize the go1.27 standard-library uuid.UUID by @fredbi ...

Miscellaneous tasks

• chore: prepare release v0.36.2 by @bot-go-openapi[bot] in #78 ...

Other (technical)

• Stdlib UUID (go1.27) by @fredbi in #77 ...

0.36.1 - 2026-08-01

Sync up with genspec-tui standalone release

Full Changelog: v0.36.0...v0.36.1

5 commits in this release.

Fixed bugs

• fix(scanner): stop dropping negative and computed swagger:enum members by @fredbi ...

Documentation

• docs(doc-site): give enums their own tutorial page by @fredbi ...
• doc: updated contributors file by @bot-go-openapi[bot] in #74 ...

Miscellaneous tasks

• chore: removed replace to release cmd/genspec-tui by @fredbi ...

Other (technical)

• Fix/3412 enum negative by @fredbi in #76 ...

People who contributed to this release

• @fredbi

codescan license terms

Per-module changes

cmd/genspec-tui (0.36.1)

Miscellaneous tasks

• chore: removed replace to release cmd/genspec-tui by @fredbi ...

docs/examples (0.36.1)

Documentation

• docs(doc-site): give enums their own tutorial page by @fredbi ...

Other (technical)

• Fix/3412 enum negative by @fredbi in #76 ...

fixtures (0.36.1)

Fixed bugs

• fix(scanner): stop dropping negative and computed swagger:enum members by @fredbi ...

Other (technical)

• Fix/3412 enum negative by @fredbi in #76 ...

0.36.0 - 2026-07-31

TUI tool

Also features: polymorphic subtypes discovery, swagger:omit directive

Full Changelog: v0.35.1...v0.36.0

24 commits in this release.

Implemented enhancements

• feat(schema): add swagger:omit, the author's escape hatch for embed conflicts by @fredbi ...
• feat(spec): auto-discover discriminator subtypes of a referenced base by @fredbi ...

Fixed bugs

• fix(genspec-tui): drop the YAML position workarounds, upgrade core to v0.0.3 by @fredbi in #71 ...

Documentation

• fix: keep .txt golden fixtures LF on Windows checkouts by @fredbi ...
• docs(doc-site): show the first-class alias modes instead of describing them by @fredbi ...
• docs(quirks): retire the resolved quirk entries, point at the live register by @fredbi ...
• docs(doc-site): document swagger:omit by @fredbi ...
• doc: updated roadmap by @fredbi in #66 ...

Code quality

• build: add the genspec-tui module to the monorepo workspace by @fredbi ...
• feat(genspec-tui): interactive TUI that live-renders a spec from source by @fredbi ...
• docs(doc-site): document how discriminator subtypes are discovered by @fredbi ...

Miscellaneous tasks

• chore: prepare release v0.36.0 by @bot-go-openapi[bot] in #73 ...
• chore: fix missing go file in sub-module by @fredbi ...
• ci: release codescan as the mono-repo it now is by @fredbi in #72 ...

Updates

• chore(deps): Bump go.yaml.in/yaml/v3 by @dependabot[bot] ...
• chore(deps): Bump the go-openapi-dependencies group with 2 updates by @dependabot[bot] in #69 ...
• chore(deps): Bump the development-dependencies group across 1 directory with 10 updates by @dependabot[bot] in #64 ...
• chore(deps): Bump the go-openapi-dependencies group with 3 updates by @dependabot[bot] in #63 ...
• chore(deps): Bump the development-dependencies group with 3 updates by @dependabot[bot] in #62 ...

Other (technical)

• Feat/genspec tui by @fredbi in #38 ...
• chore(deps): Bump go.yaml.in/yaml/v3 from 3.0.4 to 3.0.5 in the other-dependencies group across 1 directory by @fredbi in #70 ...
• Docs/quirks register cleanup by @fredbi in #68 ...
• Feat/swagger omit by @fredbi in #67 ...
• Polymorphic subtypes discovery by @fredbi in #65 ...

People who contributed to this release

• @fredbi

codescan license terms

Per-module changes

cmd/genspec-tui (0.36.0)

Fixed bugs

• fix(genspec-tui): drop the YAML position workarounds, upgrade core to v0.0.3 by @fredbi in #71 ...

Code quality

• feat(genspec-tui): interactive TUI that live-renders a spec from source by @fredbi ...

Miscellaneous tasks

• chore: prepare release v0.36.0 by @bot-go-openapi[bot] in #73 ...

Other (technical)

• Feat/genspec tui by @fredbi in #38 ...

docs/examples (0.36.0)

Fixed bugs

• fix(genspec-tui): drop the YAML position workarounds, upgrade core to v0.0.3 by @fredbi in #71 ...

Documentation

• docs(doc-site): show the first-class alias modes instead of describing them by @fredbi ...
• docs(quirks): retire the resolved quirk entries, point at the live register by @fredbi ...
• docs(doc-site): document swagger:omit by @fredbi ...

Code quality

• build: add the genspec-tui module to the monorepo workspace by @fredbi ...
• docs(doc-site): document how discriminator subtypes are discovered by @fredbi ...

Miscellaneous tasks

• chore: prepare release v0.36.0 by @bot-go-openapi[bot] in #73 ...

Other (technical)

• Feat/genspec tui by @fredbi in #38 ...
• Docs/quirks register cleanup by @fredbi in #68 ...
• Feat/swagger omit by @fredbi in #67 ...
• Polymorphic subtypes discovery by @fredbi in #65 [...](https://github.com/go-opena...

0.35.1 - 2026-07-16

Full Changelog: v0.35.0...v0.35.1

68 commits in this release.

Implemented enhancements

• feat(scanner): swagger:description | end-to-end + fixture; closes go-swagger#3211 by @fredbi ...
• feat(grammar): swagger:description | literal block scalar (lexer capture) by @fredbi ...
• feat(scanner): DefaultAllOfForEmbeds — opt-in allOf composition for plain embeds by @fredbi ...
• feat(scanner): SkipJSONifyInterfaceMethods — opt out of interface-method mangler by @fredbi ...
• feat(scanner): CleanGoDoc — marker contract for idiom recomposition by @fredbi ...
• feat(scanner): AfterDeclComments — field trailing comments (Phase B) by @fredbi ...
• feat(scanner): AfterDeclComments — annotations inside/below type decls (Phase A) by @fredbi ...
• feat(overrides): multi-line swagger:description + keyword co-location by @fredbi ...
• feat(overrides): apply swagger:description on responses & headers by @fredbi ...
• feat(overrides): apply swagger:title / swagger:description on schemas by @fredbi ...
• feat(overrides): register swagger:title / swagger:description annotations by @fredbi ...
• feat(shared-parameters): validate shared-namespace refs, drop danglers by @fredbi ...
• feat(shared-parameters): swagger:response * synonym + keep-first conflict by @fredbi ...
• feat(shared-parameters): apply path-item parameters from swagger:parameters /path by @fredbi ...
• feat(shared-parameters): wire shared parameters into operations as $refs by @fredbi ...
• feat(shared-parameters): register top-level #/parameters with keep-first conflict by @fredbi ...
• feat(shared-parameters): grammar-owned targeting parse + scanner ref discovery by @fredbi ...
• feat: response-level examples by mime on struct swagger:response by @fredbi ...
• feat: derive field names from configurable struct tags (NameFromTags) by @fredbi ...
• feat(scanner): prune unreferenced models under -m (PruneUnusedModels) by @fredbi ...

Fixed bugs

• refactor(resolvers): resolve TextMarshaler via a source-checked interface by @fredbi ...
• fix(provenance): re-point definition anchors through name reduction by @fredbi ...

Documentation

• doc: updated contributors file by @bot-go-openapi[bot] in #57 ...
• docs(doc-site): document swagger:title / swagger:description annotations by @fredbi ...
• docs(doc-site): railroad (syntax) diagrams for the EBNF grammar by @fredbi ...
• docs(doc-site): rework annotation pages — Usage quick-form + live examples by @fredbi ...
• docs(doc-site): one page per swagger:* annotation; alpha-sort the index by @fredbi ...
• doc: updated roadmap ; clean up comments by @fredbi ...
• doc: reformatted go comments by @fredbi ...
• docs(doc-site): tabbed-example pilot — live SwaggerUI on a tutorial pane by @fredbi ...
• docs: subsection the "Shaping the output" menu + add Options reference by @fredbi ...
• docs: doc-site coverage for AfterDeclComments by @fredbi ...
• docs: doc-site coverage for swagger:title / swagger:description overrides by @fredbi ...
• docs: doc-site coverage for shared parameters & responses by @fredbi ...
• docs(grammar): document swagger:description | literal block by @fredbi ...
• docs(builders): document CleanGoDoc — godoclink README + scanner §clean-godoc by @fredbi ...
• docs(scanner): document AfterDeclComments; alias coverage; defer const-enum by @fredbi ...
• docs(overrides): document swagger:title / swagger:description overrides by @fredbi ...
• feat(shared-parameters): prune unreferenced shared params/responses under -m by @fredbi ...
• docs: doc-site coverage for NameFromTags and response examples by mime by @fredbi ...
• doc: publish 2026 roadmap for codescan by @fredbi in #52 ...
• ci: post README announcements to discord + bump ci-workflows to v0.4.0 by @fredbi ...

Code quality

• chore: relint by @fredbi ...
• docs(doc-site): generalize the live-spec tab into example by @fredbi ...
• docs(doc-site): render the capstone spec live with Swagger UI (W1) by @fredbi ...
• docs: doc-site coverage for swagger:description | (verbatim markdown) by @fredbi ...
• docs: doc-site coverage for DefaultAllOfForEmbeds + SkipJSONifyInterfaceMethods by @fredbi [...](fb38ec...

0.35.0 - 2026-06-21

Big bug-bashing release

Full Changelog: v0.34.1...v0.35.0

267 commits in this release.

Implemented enhancements

• feat(spec): recover builder panics with a located diagnostic by @fredbi ...
• feat(scanner): fail loud on a degraded package load by @fredbi ...
• feat(builders): emit cross-ref provenance anchors by @fredbi ...
• feat(scanner): provenance hooks and diagnostic-dedup infrastructure by @fredbi ...
• feat(grammar): expose keyword→spec-pointer mapping (PointerPath) by @fredbi ...
• feat(parser): add SingleLineCommentAsDescription option by @fredbi ...
• feat(schema): add EmitXGoType option to stamp x-go-type on definitions by @fredbi ...
• feat(schema): resolve cross-package leaf type names in type-name keywords by @fredbi ...
• feat(spec): name-identity deconfliction for colliding definition names by @fredbi ...
• feat(schema): typed swagger:patternProperties marker by @fredbi ...
• feat(responses): emit x-go-enum-desc on enum-typed response headers (go-swagger#2922) by @fredbi ...
• feat(externalDocs): support externalDocs on operation and full schema by @fredbi ...
• feat(scanner): add SkipEnumDescriptions to keep enum const mapping out of descriptions (go-swagger#2922) by @fredbi ...
• feat(responses): support primitive response bodies via body: tag (go-swagger#2942) by @fredbi ...

Fixed bugs

• fix(builders): correct jsonpointer provenance instrumentation by @fredbi ...
• fix(schema): emit additionalProperties for json-stringifiable map keys (go-swagger#2251) by @fredbi ...
• fix(parameters): honour swagger:type override on parameter fields (go-swagger#1499) by @fredbi ...
• fix(schema): honour the name: keyword on model fields & interface methods (quirk G2) by @fredbi ...
• fix(routes): derive body: response description instead of echoing the type name (quirk G1) by @fredbi ...
• fix(schema): keep model+override inline in a SimpleSchema (F1/F4 follow-up) by @fredbi ...
• fix(schema): support bare swagger:enum on a type decl (F4b, part C) by @fredbi ...
• fix(schema): swagger:model + override publishes a definition + $ref (F1/F2/F4, parts A+B) by @fredbi ...
• fix(schema): deprecate swagger:alias to an empty sink (F8) by @fredbi ...
• fix(schema): honour swagger:name on struct fields (quirk F5) by @fredbi ...
• fix(yaml): parse gofmt-canonical swagger:operation YAML bodies (F7 operations) by @fredbi ...
• fix(parameters,responses): guard map fields in OAS2 SimpleSchema targets (go-swagger#2804) by @fredbi ...
• fix(scanner): warn on non-identifier swagger:model/response names (go-swagger#874) by @fredbi ...

Refactor

• refactor: retire internal/logger; route scan observations through diagnostics by @fredbi in #49 ...

Documentation

• feat(schema): optional $ref-sibling rendering (EmitRefSiblings, SkipAllOfCompounding) by @fredbi in #47 ...
• doc: updated contributors file by @bot-go-openapi[bot] in #46 ...
• docs: remove the stale duplicate usage/getting-started section by @fredbi ...
• docs: document the EmitXGoType and SingleLineCommentAsDescription knobs by @fredbi ...
• docs: flip "Resolving $ref name conflicts" live with test-backed panes by @fredbi ...
• docs: reference entries for additionalProperties & patternProperties by @fredbi ...
• docs: new 'Maps & free-form objects' tutorial with test-backed examples by @fredbi ...
• docs: swagger:type override on parameter fields (go-swagger#1499) by @fredbi ...
• docs: compose a response body from several models via swagger:allOf (#2592) by @fredbi ...
• docs: structured example on a $ref'd field + shared-model per-response examples (quirk G3, #2871) by @fredbi ...
• docs: reframe name: as the universal field-naming keyword (quirk G2) by @fredbi ...
• docs: showcase the G1-fixed derived response description in inline-response-bodies by @fredbi ...
• docs: correct name:/swagger:name scope (they are complementary, not equivalent) by @fredbi ...
• docs: scaffold a draft "Resolving $ref name conflicts" Shaping section by @fredbi ...
• docs: note model-level Extensions in the vendor-extensions how-to by @fredbi ...
• docs: reconcile doc-site with the F-series quirk fixes by @fredbi ...
• docs(spec): correct stale externalDocs comment in meta walker by @fredbi ...
• docs: swagger:parameters docs example is invalid OAS2 (go-swagger#279...

0.34.1 - 2026-06-11

Full Changelog: v0.34.0...v0.34.1

40 commits in this release.

Implemented enhancements

• feat(scanner): grammar seam by @fredbi ...
• feat(builders/parameters,responses): annotation builders by @fredbi ...
• feat(builders/schema): grammar-based schema builder by @fredbi ...
• feat(builders/resolvers): schema-for-type + items-chain adapters by @fredbi ...
• feat(builders/validations): type-aware coercion and shape checks by @fredbi ...
• feat(builders/handlers): shared Walker callback factories by @fredbi ...
• feat(builders/common): shared Builder state and cache by @fredbi ...
• feat(parsers/yaml): YAML sub-parser by @fredbi ...
• feat(grammar): Walker visitor + Diagnostic surface by @fredbi ...
• feat(grammar): recursive-descent parser + typed Block family by @fredbi ...
• feat(grammar): lexer — tokenize annotations and keywords by @fredbi ...

Fixed bugs

• fix(schema): honour swagger:strfmt on alias declarations by @fredbi ...
• fix(responses): annotation gates first-class alias identity at use sites by @fredbi ...
• fix(schema): annotation gates first-class alias identity at use sites by @fredbi ...
• fix(schema): aliased embeds follow the named-embed dispatch by @fredbi ...
• fix(schema): honour stdlib recognizers across alias dispatch paths by @fredbi ...

Refactor

• refactor(parameters,responses): replace deprecated FindModel with GetModel by @fredbi ...

Documentation

• doc: updated contributors file by @bot-go-openapi[bot] in #30 ...
• docs(schema): Q9 — pin swagger:name verbatim contract; document principled asymmetry by @fredbi ...
• fix(grammar,parameters,responses,routebody): Q29 — case-insensitive in: comparison by @fredbi ...

Code quality

• fix(parameters): annotation gates first-class alias identity at use sites by @fredbi ...
• chore: fixed linting (fixtures excluded from auto-fix by formatter by @fredbi ...
• chore: loose ends by @fredbi ...
• feat(grammar): preprocessor — comment-group to positioned lines by @fredbi ...

Testing

• test(integration): witness fixture for FindModel→GetModel migration by @fredbi ...
• test(integration): golden-file test harness + quirk story by @fredbi ...

Miscellaneous tasks

• ci: added bot pr monitor by @fredbi in #33 ...
• test(integration): Q26 — regression-detector for TOS↔Schemes terminator by @fredbi ...

Security

• docs(builders): consolidate alias-handling contract; scrub planning vocabulary by @fredbi ...
• fix(grammar,yaml): Q28 — securityDefinitions indent + duplicate-key dedupe by @fredbi ...
• docs: annotation + grammar reference by @fredbi ...
• feat(builders/spec): meta + orchestrator by @fredbi ...
• feat(builders/routes): route discovery + body parsing by @fredbi ...
• feat(builders/operations): operation annotation builder by @fredbi ...
• feat(parsers/routebody): swagger:route body sub-parser by @fredbi ...

Updates

• chore(deps): bump the development-dependencies group across 1 directory with 7 updates by @dependabot[bot] in #29 ...
• chore(deps): bump github.com/go-openapi/spec from 0.22.4 to 0.22.5 in the go-openapi-dependencies group by @dependabot[bot] in #28 ...

Other (technical)

• Fix/aliased types by @fredbi in #32 ...
• Fix/quirks by @fredbi in #27 ...
• Feat/new parsing layer by @fredbi in #20 ...

People who contributed to this release

• @fredbi

codescan license terms