OpenAPI 3.0 and 3.1 and 3.2 (and Swagger v2) implementation for Go (parsing, converting, validation, and more)
This report summarizes scanner evidence for getkin/kin-openapi, a Go project with 3,318 GitHub stars. SynthScan examined 100,616 lines of code across 582 source files, recording 96 pattern matches distributed across 4 syntactic categories. The legacy adjusted pattern signal is 1.2 (Low pattern signal); it is not an authorship estimate.
Use the findings to ask whether maintainers can explain intent, verify dependencies, simplify unnecessary scaffolding, and focus review effort. Risk Payload v1 adds ownership, supply-chain, over-engineering, and review-effort vectors when available. These are prompts for human verification, not probabilities, security findings, or measured maintenance costs.
Use each vector to guide manual verification of the underlying findings.
Payload schema: 1.0.0 · Engine: 2.0.0 · Scoring: heuristic-density-v1 · Scan date: 2026-10-31.
Can maintainers explain intent, assumptions, and trade-offs? 88 finding(s).
Are imports declared and package/API names verified? 8 finding(s).
Are wrappers, guards, and repeated structures necessary? 0 finding(s).
Which changes need focused human review? 96 finding(s).
This chart tracks the legacy adjusted pattern score across scan runs. Changes can reflect source changes, scan coverage, or detector/scoring versions; they do not measure AI adoption or prove that a team refactored code. Compare runs only when their scoring versions are compatible. The dashed line tracks the raw pattern-hit count.
Groups findings by configured severity weight. Severity is not a confidence estimate, security rating, or proof that a package is missing. Verify imports against the project's manifests and inspect each finding in its local design context.
This horizontal bar chart shows where configured pattern scores accumulate across directories. Treat the bars as locations to inspect, not as evidence of authorship or code quality. Use the file-level findings to decide whether a directory needs a focused ownership, dependency, complexity, or review check.
The scanner identified 96 distinct pattern matches across 4 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a detector match to inspect in context. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.
Reading the findings table: The Severity column indicates the configured finding weight (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — legacy comment-context matches receive a ×1.5 score weight. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier under the legacy scoring model.
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | routers/gorillamux/example_test.go | 61 | // | COMMENT |
| LOW | openapi3/validation_error.go | 1 | package openapi3 | COMMENT |
| LOW | openapi3/validation_error.go | 21 | // failure point without string comparison. | COMMENT |
| LOW | openapi3/validation_error.go | 41 | // -> RequiredFieldError{Field: "type"} | COMMENT |
| LOW | openapi3/validation_error.go | 61 | t, ok := target.(**ValidationError) | COMMENT |
| LOW | openapi3/validation_error.go | 81 | // var ivr *InfoVersionRequired | COMMENT |
| LOW | openapi3/validation_error.go | 101 | // examples[i], etc. checked against the schema during document | COMMENT |
| LOW | openapi3/validation_error.go | 401 | // SchemaPatternRegexError clusters "schema pattern failed to compile" | COMMENT |
| LOW | openapi3/validation_error.go | 681 | func (e *DuplicateTagError) Error() string { | COMMENT |
| LOW | openapi3/schema_3point0_validator.go | 441 | func (schema *Schema) visitJSONBoolean(settings *schemaValidationSettings, value bool) (err error) { | COMMENT |
| LOW | openapi3/schema_3point0_validator.go | 461 | // | COMMENT |
| LOW | openapi3/internalize_refs.go | 21 | // | COMMENT |
| LOW | openapi3/internalize_refs.go | 521 | // InternalizeRefs removes all references to external files from the spec and moves them | COMMENT |
| LOW | openapi3/doc.go | 1 | // Package openapi3 parses and writes OpenAPI 3 specification documents. | COMMENT |
| LOW | openapi3/doc.go | 21 | // | COMMENT |
| LOW | openapi3/loader.go | 21 | } | COMMENT |
| LOW | openapi3/loader.go | 161 | return resolvedPath, nil | COMMENT |
| LOW | openapi3/loader.go | 1701 | // applyRefSiblings applies the sibling keywords of an OAS 3.1 $ref to its | COMMENT |
| LOW | openapi3/content.go | 61 | "multipart/form-data": NewMediaType().WithSchemaRef(schema), | COMMENT |
| LOW | openapi3/validation_error_context.go | 1 | // Context wrappers are the 4th category of typed validation errors, | COMMENT |
| LOW | openapi3/validation_error_context.go | 21 | // - Document-wide wrappers — SectionValidationError, | COMMENT |
| LOW | openapi3/validation_error_context.go | 41 | // | COMMENT |
| LOW | openapi3/validation_error_context.go | 101 | } | COMMENT |
| LOW | openapi3/path_item.go | 401 | COMMENT | |
| LOW | openapi3/schema.go | 181 | // Example OpenAPI 3.0 (single type): | COMMENT |
| LOW | openapi3/schema.go | 221 | // Includes returns true if the given type is included in the type array. | COMMENT |
| LOW | openapi3/schema.go | 241 | // | COMMENT |
| LOW | openapi3/schema.go | 261 | // types.IncludesNull() // true | COMMENT |
| LOW | openapi3/schema.go | 281 | } | COMMENT |
| LOW | openapi3/schema.go | 301 | // var nilTypes *Types | COMMENT |
| LOW | openapi3/walk_parameters.go | 1 | package openapi3 | COMMENT |
| LOW | openapi3/walk_parameters.go | 21 | // Returning a non-nil error aborts the walk and is returned by | COMMENT |
| LOW | openapi3/helpers.go | 141 | s2.Scheme = "file" | COMMENT |
| LOW | openapi3/helpers.go | 161 | // ├─ record.yaml | COMMENT |
| LOW | openapi3/walk_schemas.go | 21 | // "/paths/~1pets/get/responses/200/content/application~1json/schema". It is | COMMENT |
| LOW | openapi3/walk_schemas.go | 41 | // through every sub-schema keyword: properties, items, itemSchema, | COMMENT |
| LOW | openapi3/validation_options.go | 141 | // and stopping. By default, Validate is fail-fast. | COMMENT |
| LOW | openapi3/native_yaml.go | 41 | } | COMMENT |
| LOW | openapi3/native_yaml.go | 101 | // | COMMENT |
| LOW | openapi3/native_yaml.go | 121 | // Merge semantics: an explicit key wins over a merged one, and among merged | COMMENT |
| LOW | openapi3/native_yaml.go | 381 | if err := normalizeAnyFields(out); err != nil { | COMMENT |
| LOW | openapi3/native_yaml.go | 541 | return nil | COMMENT |
| LOW | openapi3/validation_code.go | 1 | package openapi3 | COMMENT |
| LOW | openapi3/origin.go | 21 | // so the map was storing information the value repeated. Here Location.Name | COMMENT |
| LOW | openapi3/error_collector.go | 1 | package openapi3 | COMMENT |
| LOW | openapi2/doc.go | 1 | // Package openapi2 parses and writes OpenAPIv2 specification documents. | COMMENT |
| LOW | internal/nodeindex/nodeindex.go | 1 | // Package nodeindex derives, from a YAML node tree and the text it was parsed | COMMENT |
| LOW | internal/nodeindex/nodeindex.go | 21 | // Index answers where the block headed by a key ends. | COMMENT |
| LOW | internal/nodeindex/nodeindex.go | 141 | start = i + 1 | COMMENT |
| LOW | .github/FUNDING.yml | 1 | # These are supported funding model platforms | COMMENT |
| LOW | .github/docs/openapi3.txt | 1721 | // func that reads whatever URI it is handed (e.g. by delegating to | COMMENT |
| LOW | openapi3filter/middleware_test.go | 581 | // 404 {"message":"Not Found","status":404} | COMMENT |
| LOW | openapi3filter/unpack_errors_test.go | 81 | panic(err) | COMMENT |
| LOW | openapi3filter/unpack_errors_test.go | 101 | // Error at "/status": value is not one of the allowed values ["available","pending","sold"] | COMMENT |
| LOW | openapi3filter/validation_kit.go | 1 | package openapi3filter | COMMENT |
| LOW | openapi3filter/validation_kit.go | 21 | // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | COMMENT |
| LOW | openapi3filter/validation_test.go | 281 | COMMENT | |
| LOW | openapi3conv/openapi3_conv.go | 21 | // so the surface stays small and additive — new options are added by | COMMENT |
| LOW | openapi3conv/doc.go | 1 | // Package openapi3conv canonicalizes an OpenAPI 3.x document into the latest | COMMENT |
| LOW | openapi3conv/doc.go | 21 | // - Out of scope: cross-major upgrades (3 → 4 if/when v4 ships). Those | COMMENT |
| 24 more matches not shown… | ||||
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| CRITICAL | openapi3/origin_test.go | 303 | base.Schema.Value.Origin.Fields.Get("type")) | CODE |
| CRITICAL | openapi3/origin_test.go | 413 | base.Flows.Implicit.Origin.Fields.Get("authorizationUrl")) | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM | openapi3/response_issue224_test.go | 21 | "description": ":dog: :cat: :rabbit: This is a sample server Petstore server. You can find out more about Swagg | CODE |
| MEDIUM | openapi2/testdata/swagger.json | 1 | {"swagger":"2.0","info":{"title":"Swagger Petstore","description":"This is a sample server Petstore server. You can fin | CODE |
| MEDIUM | openapi3filter/testdata/petstore.yaml | 3 | description: "This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io] | CODE |
| MEDIUM | openapi2conv/testdata/swagger.json | 1 | {"swagger":"2.0","info":{"title":"Swagger Petstore","description":"This is a sample server Petstore server. You can fin | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | openapi3/example_jsonschema2020_test.go | 22 | "John Doe", | CODE |
| LOW | openapi3/example_jsonschema2020_test.go | 45 | "name": "John Doe", | CODE |
| LOW | openapi3/example_jsonschema2020_test.go | 221 | "name": "John Doe", | CODE |
| LOW | openapi3/schema_if_then_else_test.go | 98 | "billingAddress": "123 Main St", | CODE |
| LOW | openapi2conv/issue187_test.go | 45 | "email": "test@test.com" | CODE |
| LOW | openapi2conv/issue187_test.go | 108 | const expected = `{"components":{"schemas":{"model.ProductSearchAttributeRequest":{"properties":{"filterField":{"type": | CODE |