fix(shapes): register ContractOrIDVCompetition nested schema alias

CONTRACT_SCHEMA/IDV_SCHEMA reference the competition leaf as
"ContractOrIDVCompetition" but only "Competition" was registered in
EXPLICIT_SCHEMAS, so competition(extent_competed,...) nested selections on
contract/IDV shapes raised ShapeValidationError. Register the name as an alias
of COMPETITION_SCHEMA. Fixes tango-python#29 item 1.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: vdavez

CHANGELOG.md

@@ -22,6 +22,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `list_contracts`: no longer sends `page=1` to the cursor-only `/api/contracts/`
   endpoint. When no cursor is supplied, neither `page` nor `cursor` is sent and
   the API returns the first page by default.
+- Shape validation: registered the `ContractOrIDVCompetition` nested schema
+  (alias of `Competition`) so nested selections like
+  `competition(extent_competed,number_of_offers_received)` on contract / IDV
+  shapes validate instead of raising `ShapeValidationError`.
 
 ### Added
 - Budget accounts surface (tango v4.6.8): `list_budget_accounts`,

tango/shapes/explicit_schemas.py

@@ -1487,6 +1487,10 @@
     "Location": LOCATION_SCHEMA,
     "PlaceOfPerformance": PLACE_OF_PERFORMANCE_SCHEMA,
     "Competition": COMPETITION_SCHEMA,
+    # Alias: CONTRACT_SCHEMA/IDV_SCHEMA reference the competition leaf as
+    # "ContractOrIDVCompetition" (the models.py dataclass name); it is the same
+    # field set as Competition. Register both so nested shape selection resolves.
+    "ContractOrIDVCompetition": COMPETITION_SCHEMA,
     "ParentAward": PARENT_AWARD_SCHEMA,
     "LegislativeMandates": LEGISLATIVE_MANDATES_SCHEMA,
     "SubawardsSummary": SUBAWARDS_SUMMARY_SCHEMA,

tests/test_shapes.py

@@ -926,6 +926,25 @@ def test_validate_field_suggestions(self):
         assert "nam" in error_msg
         assert "Did you mean" in error_msg or "name" in error_msg
 
+    def test_competition_nested_shape_on_contract(self):
+        """Regression (tango-python#29 item 1): CONTRACT_SCHEMA/IDV_SCHEMA
+        reference the competition leaf as ``ContractOrIDVCompetition``, which
+        must be registered in EXPLICIT_SCHEMAS so nested field selection like
+        ``competition(extent_competed,...)`` validates instead of raising
+        ShapeValidationError."""
+        from tango.shapes.explicit_schemas import EXPLICIT_SCHEMAS
+
+        assert "ContractOrIDVCompetition" in EXPLICIT_SCHEMAS
+        assert "extent_competed" in EXPLICIT_SCHEMAS["ContractOrIDVCompetition"]
+
+        parser = ShapeParser()
+        spec = parser.parse(
+            "key,piid,competition(extent_competed,number_of_offers_received)"
+        )
+        # Must not raise — resolves the competition leaf via the alias.
+        parser.validate(spec, "Contract")
+        parser.validate(spec, "IDV")
+
 
 class TestBuiltinModelsRegistration:
     """Test registration of built-in Tango models"""