raphgm · Oct 19, 2026
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -27,7 +27,7 @@ Look at `idle_bastion` if you want a complete existing example:
 
 - `src/cloudcost/sources/azure/idle_bastion.py`
 - `policies/idle_bastion.sql`
-- `cloudcost.idle-bastion-real.yml`
+- `examples/cloudcost.idle-bastion-real.yml`
 - the `import cloudcost.sources.azure.idle_bastion` line in `runner.py`
 
 ## Minimal worked example
@@ -99,7 +99,7 @@ The pipeline load table name (`fact_idle_nat_gateways` above) must match what th
 ### 3. Live pipeline config
 
 ```yaml
-# cloudcost.idle-nat-gateways-real.yml
+# examples/cloudcost.idle-nat-gateways-real.yml
 version: "1"
 
 pipeline:

diff --git a/README.md b/README.md
@@ -173,7 +173,7 @@ transforms:
         UsageDateTime: usage_date
 ```
 
-This was verified end-to-end against a real Azure Cost Management export (215 real cost line items, `cloudcost sync` + `cloudcost policy run` both succeeding and producing real findings) — see `cloudcost.azure-real.yml` for the full working example. AWS/OCI/Alibaba each need their own `column_map` matched to their real export schema; none of those have been verified against live data yet.
+This was verified end-to-end against a real Azure Cost Management export (215 real cost line items, `cloudcost sync` + `cloudcost policy run` both succeeding and producing real findings) — see `examples/cloudcost.azure-real.yml` for the full working example. AWS/OCI/Alibaba each need their own `column_map` matched to their real export schema; none of those have been verified against live data yet.
 
 **Independently re-verified from a completely fresh clone** (new `git clone`, new `uv venv`, new `uv pip install -e .`, no leftover state) against the same live export, confirming the fix isn't an artifact of the environment it was written in:
 

diff --git a/cloudcost.aks-idle-real.yml → examples/cloudcost.aks-idle-real.yml b/cloudcost.aks-idle-real.yml → examples/cloudcost.aks-idle-real.yml
diff --git a/cloudcost.azure-real.yml → examples/cloudcost.azure-real.yml b/cloudcost.azure-real.yml → examples/cloudcost.azure-real.yml
diff --git a/cloudcost.cosmosdb-cassandra-idle-real.yml → ...loudcost.cosmosdb-cassandra-idle-real.yml b/cloudcost.cosmosdb-cassandra-idle-real.yml → ...loudcost.cosmosdb-cassandra-idle-real.yml
diff --git a/cloudcost.cosmosdb-gremlin-idle-real.yml → .../cloudcost.cosmosdb-gremlin-idle-real.yml b/cloudcost.cosmosdb-gremlin-idle-real.yml → .../cloudcost.cosmosdb-gremlin-idle-real.yml
diff --git a/cloudcost.cosmosdb-idle-real.yml → examples/cloudcost.cosmosdb-idle-real.yml b/cloudcost.cosmosdb-idle-real.yml → examples/cloudcost.cosmosdb-idle-real.yml
diff --git a/cloudcost.cosmosdb-mongo-idle-real.yml → ...es/cloudcost.cosmosdb-mongo-idle-real.yml b/cloudcost.cosmosdb-mongo-idle-real.yml → ...es/cloudcost.cosmosdb-mongo-idle-real.yml
diff --git a/cloudcost.cosmosdb-table-idle-real.yml → ...es/cloudcost.cosmosdb-table-idle-real.yml b/cloudcost.cosmosdb-table-idle-real.yml → ...es/cloudcost.cosmosdb-table-idle-real.yml
diff --git a/cloudcost.empty-storage-real.yml → examples/cloudcost.empty-storage-real.yml b/cloudcost.empty-storage-real.yml → examples/cloudcost.empty-storage-real.yml
diff --git a/cloudcost.github-wasted-real.yml → examples/cloudcost.github-wasted-real.yml b/cloudcost.github-wasted-real.yml → examples/cloudcost.github-wasted-real.yml
diff --git a/cloudcost.idle-aci-real.yml → examples/cloudcost.idle-aci-real.yml b/cloudcost.idle-aci-real.yml → examples/cloudcost.idle-aci-real.yml
diff --git a/cloudcost.idle-acr-geo-real.yml → examples/cloudcost.idle-acr-geo-real.yml b/cloudcost.idle-acr-geo-real.yml → examples/cloudcost.idle-acr-geo-real.yml
diff --git a/cloudcost.idle-acr-real.yml → examples/cloudcost.idle-acr-real.yml b/cloudcost.idle-acr-real.yml → examples/cloudcost.idle-acr-real.yml
diff --git a/cloudcost.idle-afd-real.yml → examples/cloudcost.idle-afd-real.yml b/cloudcost.idle-afd-real.yml → examples/cloudcost.idle-afd-real.yml
diff --git a/cloudcost.idle-ai-search-real.yml → examples/cloudcost.idle-ai-search-real.yml b/cloudcost.idle-ai-search-real.yml → examples/cloudcost.idle-ai-search-real.yml
diff --git a/cloudcost.idle-aml-cluster-real.yml → examples/cloudcost.idle-aml-cluster-real.yml b/cloudcost.idle-aml-cluster-real.yml → examples/cloudcost.idle-aml-cluster-real.yml
diff --git a/cloudcost.idle-aml-compute-real.yml → examples/cloudcost.idle-aml-compute-real.yml b/cloudcost.idle-aml-compute-real.yml → examples/cloudcost.idle-aml-compute-real.yml
diff --git a/cloudcost.idle-apim-real.yml → examples/cloudcost.idle-apim-real.yml b/cloudcost.idle-apim-real.yml → examples/cloudcost.idle-apim-real.yml
diff --git a/cloudcost.idle-appconfig-real.yml → examples/cloudcost.idle-appconfig-real.yml b/cloudcost.idle-appconfig-real.yml → examples/cloudcost.idle-appconfig-real.yml
diff --git a/cloudcost.idle-appgw-real.yml → examples/cloudcost.idle-appgw-real.yml b/cloudcost.idle-appgw-real.yml → examples/cloudcost.idle-appgw-real.yml
diff --git a/cloudcost.idle-asp-real.yml → examples/cloudcost.idle-asp-real.yml b/cloudcost.idle-asp-real.yml → examples/cloudcost.idle-asp-real.yml
diff --git a/cloudcost.idle-bastion-real.yml → examples/cloudcost.idle-bastion-real.yml b/cloudcost.idle-bastion-real.yml → examples/cloudcost.idle-bastion-real.yml
diff --git a/cloudcost.idle-batch-real.yml → examples/cloudcost.idle-batch-real.yml b/cloudcost.idle-batch-real.yml → examples/cloudcost.idle-batch-real.yml
diff --git a/cloudcost.idle-cae-real.yml → examples/cloudcost.idle-cae-real.yml b/cloudcost.idle-cae-real.yml → examples/cloudcost.idle-cae-real.yml
diff --git a/cloudcost.idle-dns-real.yml → examples/cloudcost.idle-dns-real.yml b/cloudcost.idle-dns-real.yml → examples/cloudcost.idle-dns-real.yml
diff --git a/cloudcost.idle-eventhub-real.yml → examples/cloudcost.idle-eventhub-real.yml b/cloudcost.idle-eventhub-real.yml → examples/cloudcost.idle-eventhub-real.yml
diff --git a/cloudcost.idle-firewall-real.yml → examples/cloudcost.idle-firewall-real.yml b/cloudcost.idle-firewall-real.yml → examples/cloudcost.idle-firewall-real.yml
diff --git a/cloudcost.idle-fleet-manager-real.yml → ...les/cloudcost.idle-fleet-manager-real.yml b/cloudcost.idle-fleet-manager-real.yml → ...les/cloudcost.idle-fleet-manager-real.yml
diff --git a/cloudcost.idle-func-premium-real.yml → ...ples/cloudcost.idle-func-premium-real.yml b/cloudcost.idle-func-premium-real.yml → ...ples/cloudcost.idle-func-premium-real.yml
diff --git a/cloudcost.idle-grafana-real.yml → examples/cloudcost.idle-grafana-real.yml b/cloudcost.idle-grafana-real.yml → examples/cloudcost.idle-grafana-real.yml
diff --git a/cloudcost.idle-health-data-fhir-real.yml → .../cloudcost.idle-health-data-fhir-real.yml b/cloudcost.idle-health-data-fhir-real.yml → .../cloudcost.idle-health-data-fhir-real.yml
diff --git a/cloudcost.idle-lb-real.yml → examples/cloudcost.idle-lb-real.yml b/cloudcost.idle-lb-real.yml → examples/cloudcost.idle-lb-real.yml
diff --git a/cloudcost.idle-logicapp-real.yml → examples/cloudcost.idle-logicapp-real.yml b/cloudcost.idle-logicapp-real.yml → examples/cloudcost.idle-logicapp-real.yml
diff --git a/cloudcost.idle-managed-hsm-real.yml → examples/cloudcost.idle-managed-hsm-real.yml b/cloudcost.idle-managed-hsm-real.yml → examples/cloudcost.idle-managed-hsm-real.yml
diff --git a/cloudcost.idle-natgw-real.yml → examples/cloudcost.idle-natgw-real.yml b/cloudcost.idle-natgw-real.yml → examples/cloudcost.idle-natgw-real.yml
diff --git a/cloudcost.idle-openai-ptu-real.yml → examples/cloudcost.idle-openai-ptu-real.yml b/cloudcost.idle-openai-ptu-real.yml → examples/cloudcost.idle-openai-ptu-real.yml
diff --git a/cloudcost.idle-pe-real.yml → examples/cloudcost.idle-pe-real.yml b/cloudcost.idle-pe-real.yml → examples/cloudcost.idle-pe-real.yml
diff --git a/cloudcost.idle-pip-prefix-real.yml → examples/cloudcost.idle-pip-prefix-real.yml b/cloudcost.idle-pip-prefix-real.yml → examples/cloudcost.idle-pip-prefix-real.yml
diff --git a/cloudcost.idle-premiumv2-real.yml → examples/cloudcost.idle-premiumv2-real.yml b/cloudcost.idle-premiumv2-real.yml → examples/cloudcost.idle-premiumv2-real.yml
diff --git a/cloudcost.idle-redis-real.yml → examples/cloudcost.idle-redis-real.yml b/cloudcost.idle-redis-real.yml → examples/cloudcost.idle-redis-real.yml
diff --git a/cloudcost.idle-sb-real.yml → examples/cloudcost.idle-sb-real.yml b/cloudcost.idle-sb-real.yml → examples/cloudcost.idle-sb-real.yml
diff --git a/cloudcost.idle-signalr-real.yml → examples/cloudcost.idle-signalr-real.yml b/cloudcost.idle-signalr-real.yml → examples/cloudcost.idle-signalr-real.yml
diff --git a/cloudcost.idle-swa-real.yml → examples/cloudcost.idle-swa-real.yml b/cloudcost.idle-swa-real.yml → examples/cloudcost.idle-swa-real.yml
diff --git a/cloudcost.idle-tm-real.yml → examples/cloudcost.idle-tm-real.yml b/cloudcost.idle-tm-real.yml → examples/cloudcost.idle-tm-real.yml
diff --git a/cloudcost.idle-vmss-real.yml → examples/cloudcost.idle-vmss-real.yml b/cloudcost.idle-vmss-real.yml → examples/cloudcost.idle-vmss-real.yml
diff --git a/cloudcost.idle-vpn-gateway-real.yml → examples/cloudcost.idle-vpn-gateway-real.yml b/cloudcost.idle-vpn-gateway-real.yml → examples/cloudcost.idle-vpn-gateway-real.yml
diff --git a/cloudcost.law-idle-real.yml → examples/cloudcost.law-idle-real.yml b/cloudcost.law-idle-real.yml → examples/cloudcost.law-idle-real.yml
diff --git a/cloudcost.mysql-idle-real.yml → examples/cloudcost.mysql-idle-real.yml b/cloudcost.mysql-idle-real.yml → examples/cloudcost.mysql-idle-real.yml
diff --git a/cloudcost.old-snapshots-real.yml → examples/cloudcost.old-snapshots-real.yml b/cloudcost.old-snapshots-real.yml → examples/cloudcost.old-snapshots-real.yml
diff --git a/cloudcost.orphaned-nsg-real.yml → examples/cloudcost.orphaned-nsg-real.yml b/cloudcost.orphaned-nsg-real.yml → examples/cloudcost.orphaned-nsg-real.yml
diff --git a/cloudcost.pg-idle-real.yml → examples/cloudcost.pg-idle-real.yml b/cloudcost.pg-idle-real.yml → examples/cloudcost.pg-idle-real.yml
diff --git a/cloudcost.premium-disk-real.yml → examples/cloudcost.premium-disk-real.yml b/cloudcost.premium-disk-real.yml → examples/cloudcost.premium-disk-real.yml
diff --git a/cloudcost.rightsizing-real.yml → examples/cloudcost.rightsizing-real.yml b/cloudcost.rightsizing-real.yml → examples/cloudcost.rightsizing-real.yml
diff --git a/cloudcost.sql-dtu-real.yml → examples/cloudcost.sql-dtu-real.yml b/cloudcost.sql-dtu-real.yml → examples/cloudcost.sql-dtu-real.yml
diff --git a/cloudcost.stopped-vms-real.yml → examples/cloudcost.stopped-vms-real.yml b/cloudcost.stopped-vms-real.yml → examples/cloudcost.stopped-vms-real.yml
diff --git a/cloudcost.unassociated-ips-real.yml → examples/cloudcost.unassociated-ips-real.yml b/cloudcost.unassociated-ips-real.yml → examples/cloudcost.unassociated-ips-real.yml
diff --git a/cloudcost.unattached-disks-real.yml → examples/cloudcost.unattached-disks-real.yml b/cloudcost.unattached-disks-real.yml → examples/cloudcost.unattached-disks-real.yml
diff --git a/cloudcost.untagged-real.yml → examples/cloudcost.untagged-real.yml b/cloudcost.untagged-real.yml → examples/cloudcost.untagged-real.yml
diff --git a/cloudcost.vm-sizing-real.yml → examples/cloudcost.vm-sizing-real.yml b/cloudcost.vm-sizing-real.yml → examples/cloudcost.vm-sizing-real.yml
diff --git a/src/cloudcost/transforms/normalize.py b/src/cloudcost/transforms/normalize.py
@@ -21,7 +21,7 @@ def transform(self, table: pa.Table, context: Any = None) -> pa.Table:
         # of guessing at schemas, the pipeline config now declares the
         # mapping explicitly via this transform's own `config` block
         # (TransformConfig.config already existed in the schema; it was
-        # just never read). See cloudcost.azure-real.yml for a real
+        # just never read). See examples/cloudcost.azure-real.yml for a real
         # example verified against a live Azure Cost Management export.
         import datetime