docs: scrub internal-implementation language from public-facing files

Replace references to the upstream "lakehouse" with neutral language
("computed metrics", "upstream sync") in CHANGELOG, API_REFERENCE,
SHAPES, source comments, and test docstrings. Internal storage details
(e.g. "denormalized lakehouse table") replaced with capability framing
("optimized for fast pagination").

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

Author: vdavez

CHANGELOG.md

@@ -8,8 +8,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
-- Vehicles: new top-level fields `program_acronym`, `idv_count`, `total_obligated`, `is_synthetic_solicitation`, `latest_award_date`, `description`, `opportunity_id`, and a live nested `organization` object (office hierarchy) — reflecting the upstream tango lakehouse cutover (May 2026).
-- Vehicles: new `metrics(*)` shape expansion bundling 12 lakehouse metrics: `avg_offers_received`, `award_concentration_hhi`, `order_concentration_hhi`, `competed_rate`, `using_agency_count`, `avg_order_value`, `max_order_value`, `top_recipient_share`, `recent_obligations_24mo`, `recent_orders_24mo`, `days_since_last_order`, `obligation_to_ceiling_ratio`. Backed by a new `VehicleMetrics` schema.
+- Vehicles: new top-level fields `program_acronym`, `idv_count`, `total_obligated`, `is_synthetic_solicitation`, `latest_award_date`, `description`, `opportunity_id`, and a live nested `organization` object (awarding-org snapshot) — tracking the upstream tango vehicles surface.
+- Vehicles: new `metrics(*)` shape expansion bundling 12 computed metrics: `avg_offers_received`, `award_concentration_hhi`, `order_concentration_hhi`, `competed_rate`, `using_agency_count`, `avg_order_value`, `max_order_value`, `top_recipient_share`, `recent_obligations_24mo`, `recent_orders_24mo`, `days_since_last_order`, `obligation_to_ceiling_ratio`. Backed by a new `VehicleMetrics` schema.
 - `list_vehicle_orders(uuid, ...)` for the new `/api/vehicles/{uuid}/orders/` endpoint, returning task orders under the vehicle's IDVs with two-phase pagination.
 - `ordering` parameter on `list_vehicles` (whitelist: `vehicle_obligations`, `latest_award_date`; prefix `-` for descending) and on `list_vehicle_orders` (whitelist: `award_date`, `obligated`, `total_contract_value`).
 - `ShapeConfig.VEHICLE_ORDERS_MINIMAL` default for the new orders endpoint.

docs/API_REFERENCE.md

@@ -556,7 +556,7 @@ awardees = client.list_vehicle_awardees(
 
 ### list_vehicle_orders()
 
-List task orders under a vehicle's IDVs (`/api/vehicles/{uuid}/orders/`). Backed by a denormalized lakehouse table for fast pagination over large vehicles.
+List task orders under a vehicle's IDVs (`/api/vehicles/{uuid}/orders/`). Optimized for fast pagination over large vehicles.
 
 ```python
 orders = client.list_vehicle_orders(
@@ -602,7 +602,7 @@ The post-cutover (May 2026) vehicle response includes these top-level fields, al
 ### Vehicle shape expansions
 
 - `awardees(...)` — underlying IDV awards. Supports nested `orders(...)`.
-- `metrics(*)` — bundled lakehouse metrics: `avg_offers_received`, `award_concentration_hhi`, `order_concentration_hhi`, `competed_rate`, `using_agency_count`, `avg_order_value`, `max_order_value`, `top_recipient_share`, `recent_obligations_24mo`, `recent_orders_24mo`, `days_since_last_order`, `obligation_to_ceiling_ratio`. Defaults included in `ShapeConfig.VEHICLES_COMPREHENSIVE`.
+- `metrics(*)` — bundled computed metrics: `avg_offers_received`, `award_concentration_hhi`, `order_concentration_hhi`, `competed_rate`, `using_agency_count`, `avg_order_value`, `max_order_value`, `top_recipient_share`, `recent_obligations_24mo`, `recent_orders_24mo`, `days_since_last_order`, `obligation_to_ceiling_ratio`. Defaults included in `ShapeConfig.VEHICLES_COMPREHENSIVE`.
 - `organization` — live awarding-org snapshot (selected as a leaf field; not sub-selectable).
 
 ### Deprecated shape fields

docs/SHAPES.md

@@ -59,7 +59,7 @@ grants = client.list_grants(shape=ShapeConfig.GRANTS_MINIMAL)
 
 **Available constants:** Contracts (`CONTRACTS_MINIMAL`), Entities (`ENTITIES_MINIMAL`, `ENTITIES_COMPREHENSIVE`), Forecasts, Opportunities, Notices, Grants, IDVs, Vehicles (`VEHICLES_MINIMAL`, `VEHICLES_COMPREHENSIVE`, `VEHICLE_AWARDEES_MINIMAL`, `VEHICLE_ORDERS_MINIMAL`), Organizations, OTAs, OTIDVs, Subawards. See [API Reference – ShapeConfig](API_REFERENCE.md#shapeconfig-predefined-shapes) for the full table and which method uses which constant.
 
-> **Vehicles `metrics(*)` expansion:** The post-cutover (May 2026) vehicles surface bundles 12 lakehouse metrics under a single `metrics(*)` expansion (e.g. `award_concentration_hhi`, `competed_rate`, `top_recipient_share`). It is included in `VEHICLES_COMPREHENSIVE` by default. The `agency_details`, `competition_details`, and `opportunity` shape entries are deprecated and emit `DeprecationWarning` if requested explicitly.
+> **Vehicles `metrics(*)` expansion:** The vehicles surface bundles 12 computed metrics under a single `metrics(*)` expansion (e.g. `award_concentration_hhi`, `competed_rate`, `top_recipient_share`). It is included in `VEHICLES_COMPREHENSIVE` by default. The `agency_details`, `competition_details`, and `opportunity` shape entries are deprecated and emit `DeprecationWarning` if requested explicitly.
 
 ## Basic Shaping
 

tango/shapes/explicit_schemas.py

@@ -838,7 +838,7 @@
 }
 
 
-# Vehicles expose a "metrics(...)" expansion bundling lakehouse-computed metrics.
+# Vehicles expose a "metrics(...)" expansion bundling computed metrics.
 VEHICLE_METRICS_SCHEMA: dict[str, FieldSchema] = {
     "avg_offers_received": FieldSchema(
         name="avg_offers_received", type=float, is_optional=True, is_list=False

tests/integration/test_vehicles_idvs_integration.py

@@ -91,7 +91,7 @@ def test_list_vehicles_uses_default_shape_and_search(self, tango_client):
             )
             assert isinstance(solicitation_date, date), "solicitation_date should be date"
 
-        # Post-cutover (May 2026) lakehouse fields. All optional — only verify type when present.
+        # New vehicle fields. All optional — only verify type when present.
         is_synth = _field(vehicle, "is_synthetic_solicitation")
         if is_synth is not None:
             assert isinstance(is_synth, bool), "is_synthetic_solicitation should be bool"
@@ -254,7 +254,7 @@ def test_list_vehicles_with_ordering(self, tango_client):
 
     @handle_api_exceptions("vehicles")
     def test_get_vehicle_with_metrics_expansion(self, tango_client):
-        """`metrics(*)` expansion returns the 12 lakehouse metric fields with correct types."""
+        """`metrics(*)` expansion returns the 12 metric fields with correct types."""
         list_response = tango_client.list_vehicles(limit=1)
         if not list_response.results:
             pytest.skip("No vehicles available to test metrics expansion")
@@ -266,7 +266,7 @@ def test_get_vehicle_with_metrics_expansion(self, tango_client):
 
         metrics = _field(vehicle, "metrics")
         if metrics is None:
-            pytest.skip("Vehicle has no metrics row yet (lakehouse sync may be pending)")
+            pytest.skip("Vehicle has no metrics yet (upstream sync may be pending)")
 
         assert isinstance(metrics, dict), "metrics expansion should be a dict"
         # Float-typed metrics