sourcecode 1.38.0__tar.gz → 1.41.0__tar.gz

sourcecode-1.41.0/CHANGELOG.md

@@ -0,0 +1,123 @@
+# Changelog
+
+## [1.41.0] — 2026-06-16
+
+### Added
+- **Fase 21 — spec-recovered HTTP routes reach `impact-chain`.** In
+  openapi-generator "interface-only" repos (`@RestController implements XxxApi`,
+  mappings on the generated interface under `target/generated-sources`), the HTTP
+  surface is recovered from the OpenAPI spec. That recovery previously lived only in
+  the `endpoints` command path, so `impact-chain` on a repository/service symbol
+  reported `endpoints_affected = 0` even though the route existed. The spec→controller
+  linking is now shared and wired through the impact model end to end.
+- **21-02** — `_recover_openapi_spec_routes` (repository_ir): single shared helper that
+  links spec operations to interface-defined controllers and emits both the
+  `endpoints`-command shape and the `route_surface` shape. `build_repo_ir` merges the
+  spec-sourced `route_surface` entries, so they flow `route_surface → CanonicalRepositoryIR
+  → EndpointIndex → impact-chain`. The `endpoints` command output stays byte-identical.
+- **21-03** — `impact-chain` BFS now crosses the interface DI boundary mid-chain.
+  `_bfs_callers` takes the `ImplementationGraph` and, for each implementation class it
+  reaches, folds in the reverse edges of that class's interfaces (callers inject the
+  interface type, so the `injects` edges sit on the interface node). Closes
+  `repo → serviceImpl → (service interface) → controller` so the spec-recovered endpoint
+  surfaces. CH-001b already did this for the seed; 21-03 extends it to every impl in the
+  traversal.
+
+### Fixed
+- **BUG-PARSER-002 — multi-line constructor/method signatures.** A signature whose
+  parameter list spans several physical lines (the canonical Spring constructor-injection
+  idiom, one param per line) lost its parameters: the per-line decl regex captured `[^)]*`
+  up to end-of-line only, so `param_types` was empty and no `injects` edges were emitted.
+  The pre-join pass now balances parentheses for declaration openers, mirroring the
+  existing multi-line class-declaration join.
+- **BUG-PARSER-003 — wildcard-import dependency resolution.** A dependency type pulled in
+  via `import pkg.*` was never resolved to an FQN (`import_map` skips `.*`), so even a
+  single-line constructor produced no `injects` edge. `_build_relations` now receives the
+  global `{package → {simple → FQN}}` map and resolves wildcard-imported types against it.
+
+### Why
+Field test of spring-petclinic-rest issue #11 (weakness #2): `impact-chain` on a repo or
+service symbol surfaced no affected HTTP endpoints in interface-only openapi-generator
+repos, even though the `endpoints` command listed the routes. The break was structural at
+several layers — the spec→controller linking never reached `route_surface`/the CIR, the DI
+chain dead-ended at the service impl, and (the live-repo blocker) the very first hop
+repo→service was missing because petclinic's `ClinicServiceImpl` uses a multi-line
+constructor with a wildcard repository import. With all four fixes, the live E2E
+`impact-chain VetRepository` on petclinic-rest goes from **0** affected endpoints to the
+full transitive set (**35**, reaching every controller incl. the spec-recovered v2 routes).
+
+## [1.40.0] — 2026-06-16
+
+### Added
+- **CH-001c — interface impact models implementors.** `impact-chain` over an
+  interface or abstract base now resolves its full in-repo descendant set:
+  concrete `implements` classes, `extends` sub-interfaces, and subclasses, traversed
+  transitively. A base interface query reaches impls hidden behind an intermediate
+  sub-interface (e.g. Spring Data repositories: `SpringDataVetRepository extends
+  VetRepository` alongside the JPA/JDBC impls).
+- `ImplementationGraph` gains `subtypes_of()`, `supertypes_of()`, and
+  `all_subtypes_of()` (transitive, cycle-safe). `extends` edges are now captured;
+  `implements`-only indices (`implementations_of`/`primary_implementation`) keep their
+  strict DI-resolution semantics — sub-interfaces are not counted as bean implementations.
+- `ImpactChainResult.implementations`: new output field listing the in-repo subtypes
+  of the queried type, making the implementation blast radius visible (previously the
+  impls were silent BFS seeds).
+
+### Why
+Field test of spring-petclinic-rest issue #11 surfaced the gap: `impact-chain
+VetRepository` returned only the SpringData sub-interface, missing the JPA/JDBC impls —
+exactly the "3 impls" graph the maintainer cared about. Interface impact did not model
+implementors.
+
+## [1.33.0] — 2026-05-29
+
+### Changed
+- **Repositioned product identity** around persistent structural cache and ultra-fast repeated analysis for AI coding agents. Cache is now the central product story, not a performance feature.
+- README rewritten: new intro emphasizing persistent context engine, cache performance benchmarks promoted above quickstart, agent workflow patterns section added, "Java/Spring analysis CLI" framing moved down.
+- `pyproject.toml` description updated: "Persistent structural context and ultra-fast repeated analysis for AI coding agents".
+- CLI `--help` updated: tagline, cold/warm latency numbers, cache commands section added prominently.
+
+## [Unreleased]
+
+### Added
+- `prepare-context generate-tests --include-config`: opt-in flag to include tooling
+  config files (`.eslintrc*`, `karma.conf.js`, `jest.config.js`, etc.) in `test_gaps`.
+  By default these are now excluded (IMP-1).
+
+### Fixed
+- **BUG-1** `repo-ir` stdout: JSON is now written via `stdout.buffer` (UTF-8) so Unicode
+  characters (e.g. `→`) survive on Windows consoles with non-UTF-8 codecs.
+  `main_entry` also calls `stdout.reconfigure(encoding='utf-8')` on startup.
+- **BUG-2** `--exclude` with a space-separated value (`--exclude "a,b"`) was silently
+  consumed as the repository path. Added `--exclude` to the options-with-value registry
+  so its argument is parsed correctly.
+- **BUG-3** `prepare-context onboard --fast` returned only the git-changed file
+  (e.g. `.idea/vcs.xml`). Fast mode for `onboard` now always uses a shallow depth-2
+  scan so manifests and entry points are reliably discovered.
+- **BUG-4** `angular_version: null` when `package.json` has `"dependencies": null`.
+  The merge now uses `or {}` so an explicit `null` key doesn't raise TypeError.
+  Also checks `peerDependencies` as a fallback source.
+- **BUG-5** `lazy_routes_count: 0` in Angular projects. Counting now uses
+  `loadChildren:` and `loadComponent:` (property syntax) instead of the defunct
+  `loadChildren(` call syntax.
+- **BUG-6** Angular `*.component.ts` files classified as Spring `@Service` in
+  `review-pr` and `prepare-context` output on fullstack Java+Angular repos.
+  Root cause: `"component"` was in `_SERVICE_KW` inside `_classify_changed_file`.
+  Fix: Angular detection block (by `.ts` stem suffix) now runs **before** the
+  Java/Spring heuristics. `"component"` removed from `_SERVICE_KW`. Added
+  `ng_component`, `ng_pipe`, `ng_directive`, `ng_guard`, `ng_interceptor`,
+  `ng_resolver`, `ng_service`, `ng_module` to `_ARTIFACT_CHANGE_EFFECT`.
+  `ast_extractor._detect_role` updated with the same Angular stem-suffix map.
+- **BUG-7** `--compact` help text referenced `--slim (when available)` which is
+  not implemented and does not exist as a CLI option, causing user confusion
+  (`Error: No such option '--slim'`). Removed the reference (Option A: remove
+  mention rather than implement the flag this sprint).
+
+### Regression tests added (`tests/test_bug_fixes_v13122.py`)
+- 13 exit-code tests covering all commands reported as EXIT 255 — all verified
+  to return EXIT 0 (BUG-1 through BUG-7 of this audit cycle).
+- 8 Angular classification tests locking `ng_component` / `ng_service` / `ng_*`
+  artifact types and `_ARTIFACT_CHANGE_EFFECT` entries.
+- 3 `--slim` tests verifying the option is absent from help and CLI surface.
+- 6 `angular_version` parsing tests covering `dependencies`, `devDependencies`,
+  `peerDependencies`, `null` JSON values, and version prefix stripping.

{sourcecode-1.38.0 → sourcecode-1.41.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.38.0
+Version: 1.41.0
 Summary: Persistent structural context and ultra-fast repeated analysis for AI coding agents
 License-File: LICENSE
 Keywords: agents,ai,codebase,context,developer-tools,llm
@@ -40,7 +40,7 @@ Description-Content-Type: text/markdown
 
 **Persistent structural context and ultra-fast repeated analysis for AI coding agents.**
 
-![Version](https://img.shields.io/badge/version-1.38.0-blue)
+![Version](https://img.shields.io/badge/version-1.39.0-blue)
 ![Python](https://img.shields.io/badge/python-3.9%2B-green)
 
 ---
@@ -114,7 +114,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.38.0
+# sourcecode 1.39.0
 ```
 
 ---
@@ -149,6 +149,9 @@ sourcecode impact-chain OrderPlacedEvent /path/to/repo --type events
 # REST endpoint surface
 sourcecode endpoints /path/to/repo
 
+# Request-body validation per endpoint: constraints + custom validators (free)
+sourcecode validation /path/to/repo
+
 # Onboard to an unfamiliar codebase
 sourcecode onboard /path/to/repo
 

{sourcecode-1.38.0 → sourcecode-1.41.0}/README.md

@@ -2,7 +2,7 @@
 
 **Persistent structural context and ultra-fast repeated analysis for AI coding agents.**
 
-![Version](https://img.shields.io/badge/version-1.38.0-blue)
+![Version](https://img.shields.io/badge/version-1.39.0-blue)
 ![Python](https://img.shields.io/badge/python-3.9%2B-green)
 
 ---
@@ -76,7 +76,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.38.0
+# sourcecode 1.39.0
 ```
 
 ---
@@ -111,6 +111,9 @@ sourcecode impact-chain OrderPlacedEvent /path/to/repo --type events
 # REST endpoint surface
 sourcecode endpoints /path/to/repo
 
+# Request-body validation per endpoint: constraints + custom validators (free)
+sourcecode validation /path/to/repo
+
 # Onboard to an unfamiliar codebase
 sourcecode onboard /path/to/repo
 

{sourcecode-1.38.0 → sourcecode-1.41.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "1.38.0"
+version = "1.41.0"
 description = "Persistent structural context and ultra-fast repeated analysis for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"

{sourcecode-1.38.0 → sourcecode-1.41.0}/src/sourcecode/__init__.py

@@ -1,3 +1,3 @@
 """sourcecode — Deterministic codebase context maps for AI coding agents."""
 
-__version__ = "1.38.0"
+__version__ = "1.41.0"

{sourcecode-1.38.0 → sourcecode-1.41.0}/src/sourcecode/cir_graphs.py

@@ -25,22 +25,67 @@ class ImplementationGraph:
 
     Built from implements edges where BOTH ends are known CIR symbols (internal
     interface/class pairs).  External framework interfaces are excluded.
+
+    Subtype indices (CH-001c): `extends` edges are also captured so that
+    interface-to-interface inheritance (`SubIface extends BaseIface`) and abstract
+    base classes (`SubClass extends BaseClass`) are modeled as descendants of the
+    supertype.  The `implements`-only indices (`_impl_of`/`_ifaces_of`) are kept
+    separate to preserve DI resolution semantics (primary_implementation).
     """
     _impl_of: dict[str, list[str]] = field(default_factory=dict)
     _ifaces_of: dict[str, list[str]] = field(default_factory=dict)
+    # CH-001c: union of implements + extends descendants (impl classes, sub-interfaces,
+    # subclasses) keyed by supertype FQN, and its reverse.
+    _subtype_of: dict[str, list[str]] = field(default_factory=dict)
+    _supertype_of: dict[str, list[str]] = field(default_factory=dict)
 
     # ---------------------------------------------------------------------------
     # Queries
     # ---------------------------------------------------------------------------
 
     def implementations_of(self, interface_fqn: str) -> list[str]:
-        """Return FQNs of classes that implement interface_fqn (in-repo only)."""
+        """Return FQNs of classes that implement interface_fqn (in-repo only).
+
+        Strictly `implements` edges — excludes sub-interfaces/subclasses. Use
+        subtypes_of()/all_subtypes_of() for the full impact-relevant descendant set.
+        """
         return self._impl_of.get(interface_fqn, [])
 
     def interfaces_of(self, class_fqn: str) -> list[str]:
         """Return FQNs of in-repo interfaces implemented by class_fqn."""
         return self._ifaces_of.get(class_fqn, [])
 
+    def subtypes_of(self, type_fqn: str) -> list[str]:
+        """Return direct in-repo subtypes of type_fqn.
+
+        Union of `implements` (concrete impls) and `extends` (sub-interfaces,
+        subclasses) children.  This is the impact-relevant descendant set: a change
+        to type_fqn's contract propagates to all of these.
+        """
+        return self._subtype_of.get(type_fqn, [])
+
+    def supertypes_of(self, type_fqn: str) -> list[str]:
+        """Return direct in-repo supertypes of type_fqn (implemented/extended)."""
+        return self._supertype_of.get(type_fqn, [])
+
+    def all_subtypes_of(self, type_fqn: str) -> list[str]:
+        """Return the transitive closure of in-repo subtypes (BFS, cycle-safe).
+
+        Covers multi-level hierarchies, e.g. a base interface → sub-interface →
+        concrete impl chain.  Order is breadth-first from type_fqn; deduplicated.
+        """
+        seen: set[str] = set()
+        out: list[str] = []
+        queue: list[str] = list(self._subtype_of.get(type_fqn, []))
+        while queue:
+            sub = queue.pop(0)
+            if sub in seen:
+                continue
+            seen.add(sub)
+            out.append(sub)
+            queue.extend(self._subtype_of.get(sub, []))
+        return out
+
     def primary_implementation(self, interface_fqn: str) -> str | None:
         """Return the single implementation if unambiguous, else None.
 
@@ -89,9 +134,14 @@ class ImplementationGraph:
 
         impl_of: dict[str, list[str]] = {}
         ifaces_of: dict[str, list[str]] = {}
+        subtype_of: dict[str, list[str]] = {}
+        supertype_of: dict[str, list[str]] = {}
 
         for edge in dependencies:
-            if edge.get("type") != "implements":
+            etype = edge.get("type")
+            # CH-001c: extends edges (sub-interface / subclass) are subtype relations
+            # too, even though they never feed the implements-only DI indices.
+            if etype not in ("implements", "extends"):
                 continue
             from_fqn = (edge.get("from") or "").strip()
             to_fqn = (edge.get("to") or "").strip()
@@ -110,12 +160,27 @@ class ImplementationGraph:
             if ">" in from_fqn or "<" in from_fqn:
                 continue
 
-            if from_fqn not in impl_of.get(to_fqn, []):
-                impl_of.setdefault(to_fqn, []).append(from_fqn)
-            if to_fqn not in ifaces_of.get(from_fqn, []):
-                ifaces_of.setdefault(from_fqn, []).append(to_fqn)
+            # Subtype indices — both implements and extends contribute descendants.
+            if from_fqn not in subtype_of.get(to_fqn, []):
+                subtype_of.setdefault(to_fqn, []).append(from_fqn)
+            if to_fqn not in supertype_of.get(from_fqn, []):
+                supertype_of.setdefault(from_fqn, []).append(to_fqn)
+
+            # Implements-only indices — preserve DI resolution semantics. Sub-interfaces
+            # and subclasses (extends) must NOT count as "implementations" for
+            # primary_implementation() bean resolution.
+            if etype == "implements":
+                if from_fqn not in impl_of.get(to_fqn, []):
+                    impl_of.setdefault(to_fqn, []).append(from_fqn)
+                if to_fqn not in ifaces_of.get(from_fqn, []):
+                    ifaces_of.setdefault(from_fqn, []).append(to_fqn)
 
-        return cls(_impl_of=impl_of, _ifaces_of=ifaces_of)
+        return cls(
+            _impl_of=impl_of,
+            _ifaces_of=ifaces_of,
+            _subtype_of=subtype_of,
+            _supertype_of=supertype_of,
+        )
 
 
 # ---------------------------------------------------------------------------

{sourcecode-1.38.0 → sourcecode-1.41.0}/src/sourcecode/cli.py

@@ -230,6 +230,8 @@ _SUBCOMMANDS: frozenset[str] = frozenset(
         "cold-start",
         # Spring semantic audit
         "spring-audit",
+        # Request-body validation surface
+        "validation",
         # Spring impact chain
         "impact-chain",
         # PR blast-radius report
@@ -3915,6 +3917,105 @@ def endpoints_cmd(
     _nudge()
 
 
+@app.command("validation")
+def validation_cmd(
+    path: Path = typer.Argument(
+        Path("."),
+        help="Repository path to scan for request-body validation (default: current directory)",
+    ),
+    output_path: Optional[Path] = typer.Option(
+        None, "--output", "-o",
+        help="Write output to a file instead of stdout.",
+    ),
+    format: str = typer.Option(
+        "json",
+        "--format",
+        "-f",
+        help="Output format: json (default) or yaml.",
+        show_default=True,
+    ),
+    copy: bool = typer.Option(
+        False,
+        "--copy",
+        "-c",
+        help="Copy output to system clipboard after a successful run.",
+    ),
+    path_prefix: Optional[str] = typer.Option(
+        None, "--path-prefix", "-p",
+        help="Filter endpoints whose URL path starts with this prefix.",
+    ),
+    gaps_only: bool = typer.Option(
+        False, "--gaps-only",
+        help="Report only endpoints/fields with no declared validation (the gaps section).",
+    ),
+) -> None:
+    """Map request-body validation per endpoint (constraints + custom validators).
+
+    \b
+    Aggregates two sources of bean-validation truth so an agent knows exactly
+    what a request body must satisfy before touching it:
+      * declarative constraints on the DTOs (@Pattern/@Size/@NotNull, min/max,
+        enum), recovered from the OpenAPI spec even when the DTOs are generated
+        under target/generated-sources (not scanned);
+      * hand-written custom validators (@Constraint + ConstraintValidator, e.g.
+        PetAgeValidator), linked to fields via x-field-extra-annotation.
+
+    \b
+    Output (JSON): per-endpoint validatedFields with their rules + custom
+    validators, the discovered custom-validator catalog, and the set of body
+    endpoints with no declared validation (gaps).
+
+    \b
+    Examples:
+      sourcecode validation .
+      sourcecode validation . --gaps-only
+      sourcecode validation . --path-prefix /owners
+      sourcecode validation . --format yaml
+    """
+    _enforce_format("validation", format)
+
+    target = path.resolve()
+    if not target.exists() or not target.is_dir():
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"'{target}' is not a valid directory.",
+            path=str(target),
+            hint="Pass an existing repository directory.",
+            expected="A directory path.",
+        )
+        raise typer.Exit(code=1)
+
+    from sourcecode.validation_surface import build_validation_surface
+    data = build_validation_surface(target)
+
+    if path_prefix:
+        data["endpoints"] = [
+            e for e in data.get("endpoints", [])
+            if str(e.get("path", "")).startswith(path_prefix)
+        ]
+        data["gaps"] = [
+            g for g in data.get("gaps", [])
+            if str(g.get("path", "")).startswith(path_prefix)
+        ]
+    if gaps_only:
+        data = {
+            "gaps": data.get("gaps", []),
+            "summary": data.get("summary", {}),
+        }
+
+    output = _serialize_dict(data, format)
+    _summary = data.get("summary", {})
+    _emit_command_output(
+        output, output_path, copy,
+        success_msg=f"Validation surface written to {output_path} "
+        f"({_summary.get('endpoints_with_body', 0)} body endpoints, "
+        f"{_summary.get('gaps', 0)} gaps)",
+    )
+
+    from sourcecode.mcp_nudge import nudge_mcp_if_needed as _nudge
+    _nudge()
+
+
 # ── Spring Semantic Audit ─────────────────────────────────────────────────────
 
 

{sourcecode-1.38.0 → sourcecode-1.41.0}/src/sourcecode/format_contract.py

@@ -27,6 +27,7 @@ FORMAT_REGISTRY: "dict[str, tuple[str, ...]]" = {
     "repo-ir": ("json", "yaml"),
     "impact": ("json", "yaml"),
     "endpoints": ("json", "yaml"),
+    "validation": ("json", "yaml"),
     "impact-chain": ("json", "yaml"),
     "pr-impact": ("text", "json"),
     "migrate-check": ("json", "text"),

{sourcecode-1.38.0 → sourcecode-1.41.0}/src/sourcecode/mcp/registry.py

@@ -864,6 +864,31 @@ Returns: endpoints list with method, path, controller, handler fields;
          "unknown" (no security signals detected).
 Supports Spring MVC (@GetMapping etc.) and JAX-RS (@GET/@POST etc.).
 repo_path: absolute path to the Java repository (default: current working directory).
+"""
+
+    _GET_VALIDATION_DOC = """\
+Request-body validation surface per endpoint. JAVA/SPRING ONLY.
+
+Do NOT call this on non-Java repositories — it will return empty results.
+
+Combines two sources of bean-validation truth so you know what a request body
+must satisfy before generating a payload, a test, or reasoning about a 400:
+  * declarative constraints on the DTOs (@Pattern/@Size/@NotNull, minimum/maximum,
+    enum) — recovered from the OpenAPI spec even when DTOs are generated under
+    target/generated-sources (not scanned);
+  * hand-written custom validators (@Constraint + ConstraintValidator, e.g.
+    PetAgeValidator), linked to fields via x-field-extra-annotation.
+
+Maps to: sourcecode validation <repo_path>
+Returns: endpoints[] (method, path, controller, handler, schema, validatedFields[
+  {name, rules[{kind,value}], customValidators[{annotation,validators,message,resolved}]}]),
+  custom_validators[] (catalog: annotation, validators, message, validatedTypes, targets),
+  gaps[] (POST/PUT/PATCH endpoints with no declared validation),
+  summary, openapi_spec.
+An unresolved custom annotation (referenced in the spec, no validator in source)
+is reported with resolved=false.
+repo_path: absolute path to the Java repository (default: current working directory).
+gaps_only: when true, return only the gaps section (endpoints lacking validation).
 """
 
     _CACHE_STATUS_DOC = """\
@@ -1083,6 +1108,27 @@ repo_path: absolute path to the repository (default: current working directory).
             docstring_override=_GET_ENDPOINTS_DOC,
         ),
 
+        # --- get_validation: clean alias replacing raw canonical (6 CLI params) ---
+        _alias_spec(
+            "get_validation",
+            "Request-body validation surface per endpoint (constraints + custom validators). JAVA/SPRING ONLY.",
+            ("validation",),
+            (
+                ToolParamSpec("repo_path", "argument", str, required=False, default=".", is_path=True),
+                ToolParamSpec("gaps_only", "option", bool, required=False, default=False,
+                              option_names=("--gaps-only",), is_flag=True,
+                              help="Return only endpoints/fields lacking validation."),
+            ),
+            lambda inputs: (
+                ["validation", str(inputs.get("repo_path", "."))]
+                + (["--gaps-only"] if bool(inputs.get("gaps_only")) else [])
+            ),
+            supported_targets=("repo_path",),
+            unsupported_targets=("file_path",),
+            validator=validate_repo_path,
+            docstring_override=_GET_VALIDATION_DOC,
+        ),
+
         # --- cache management: curated aliases stripping CLI noise params ---
         _alias_spec(
             "cache_status",
@@ -1214,6 +1260,7 @@ _MCP_HIDDEN_CANONICAL_TOOLS: frozenset[str] = frozenset({
     "modernize",          # duplicate of modernize_context
     # Raw CLI tools with output-format/noise params — clean alias with only repo_path exists
     "endpoints",          # 7 CLI params (output_path/format/copy/etc.); use get_endpoints
+    "validation",         # 6 CLI params (output_path/format/copy/path_prefix/gaps_only); use get_validation
     "cache_status",       # path + json_output flag; curated alias strips json_output, renames path→repo_path
     "cache_warm",         # path + compact/agent output flags; curated alias keeps only repo_path
     "cache_clear",        # path + yes/all_ destructive flags; curated alias keeps repo_path + include_ris only

{sourcecode-1.38.0 → sourcecode-1.41.0}/src/sourcecode/openapi_surface.py

@@ -68,6 +68,9 @@ class FieldConstraint:
     fmt: Optional[str] = None
     enum: Optional[list[Any]] = None
     ref: Optional[str] = None  # schema name when the field is an object/array ref
+    # Custom bean-validation annotations injected via openapi-generator's
+    # ``x-field-extra-annotation`` vendor extension (simple class names).
+    extra_annotations: "list[str]" = field(default_factory=list)
 
     def to_dict(self) -> "dict[str, Any]":
         out: "dict[str, Any]" = {"name": self.name, "required": self.required}
@@ -84,6 +87,8 @@ class FieldConstraint:
         ):
             if val is not None:
                 out[key] = val
+        if self.extra_annotations:
+            out["extraAnnotations"] = self.extra_annotations
         return out
 
 
@@ -255,6 +260,32 @@ def _ref_name(ref: Any) -> Optional[str]:
     return None
 
 
+def _extra_annotations(prop: "dict[str, Any]") -> "list[str]":
+    """Extract simple class names from ``x-field-extra-annotation``.
+
+    openapi-generator injects custom bean-validation annotations on generated DTO
+    fields via this vendor extension, e.g.
+    ``x-field-extra-annotation: "@com.x.PetAgeValidation"`` (string) or a list of
+    such entries. We keep the trailing simple name (``PetAgeValidation``).
+    """
+    import re as _re
+
+    raw = prop.get("x-field-extra-annotation")
+    if raw is None:
+        return []
+    items = raw if isinstance(raw, list) else [raw]
+    names: "list[str]" = []
+    for item in items:
+        if not isinstance(item, str):
+            continue
+        # Each entry may carry several annotations; grab every @Name token.
+        for m in _re.finditer(r"@\s*([\w.]+)", item):
+            simple = m.group(1).rsplit(".", 1)[-1]
+            if simple and simple not in names:
+                names.append(simple)
+    return names
+
+
 def _field_from_property(name: str, prop: Any, required: bool) -> FieldConstraint:
     fc = FieldConstraint(name=name, required=required)
     if not isinstance(prop, dict):
@@ -276,6 +307,7 @@ def _field_from_property(name: str, prop: Any, required: bool) -> FieldConstrain
     enum = prop.get("enum")
     if isinstance(enum, list):
         fc.enum = list(enum)
+    fc.extra_annotations = _extra_annotations(prop)
     if fc.type is None and prop.get("type") == "array":
         items = prop.get("items")
         if isinstance(items, dict):