refs #732: stabilize carrier report result schema

vpd-backoffice/config/hmm_carrier_query_contract.json

@@ -0,0 +1,28 @@
+{
+  "version": 1,
+  "purpose": "Stable structured output contract for HMM carrier performance reports",
+  "applies_to": "HMM_RDS_FEDERATION_PROFILE carrier assignment and performance questions",
+  "required_objects": [
+    "HMM_CARRIER_ASSIGNMENTS_V",
+    "HMM_RDS_CARRIER_LATEST_V"
+  ],
+  "join_contract": "Join HMM_CARRIER_ASSIGNMENTS_V.CARRIER_CODE to HMM_RDS_CARRIER_LATEST_V.CARRIER_CODE.",
+  "required_output_aliases": [
+    "EMPLOYEE_CODE",
+    "EMPLOYEE_NAME",
+    "MANAGER_EMPLOYEE_CODE",
+    "CARRIER_CODE",
+    "CARRIER_NAME",
+    "LATEST_REVENUE_USD",
+    "LATEST_GROSS_MARGIN_USD",
+    "LATEST_SCHEDULE_RELIABILITY_PCT",
+    "LATEST_RISK_LEVEL"
+  ],
+  "rules": [
+    "Return one ordinary structured row per employee and assigned carrier.",
+    "Always include every required output alias, even when the natural-language question does not explicitly request the employee columns.",
+    "Use the required ASCII uppercase underscore aliases exactly as written. Never translate aliases, insert spaces in aliases, or return HTML and Markdown.",
+    "For latest or current metrics use HMM_RDS_CARRIER_LATEST_V.",
+    "Do not add, weaken, or emulate authorization predicates. Oracle VPD on HMM_CARRIER_ASSIGNMENTS_V enforces the authenticated employee scope."
+  ]
+}