@bytebrand/export-cars 1.26.42 → 1.26.44

package/docs/autouncle/AUDIT.md

@@ -1,103 +1,103 @@
-# AutoUncle inventory feed — audit (ADV-322 / ADV-323)
-
-Status 13.10.2026, base `origin/deploy_develop` 3a025095, `@bytebrand/export-cars` 1.26.31.
-Historical documents (Confluence "autouncle [paused]", "2.7.2 Export Plugins", ACF-3604/3650/3717/3725/6172/6190)
-are evidence only. No current AutoUncle inventory schema is available; the public AutoUncle B2B
-"automotive API" is a dealer/DMS **valuation** API and is not used as a schema here.
-
-## 1. Is the export live? — No
-
-| Where | Event | State | Last run | Output |
-|---|---|---|---|---|
-| PROD Cronicle (`auto-de-prod-cronicle-01`, export-cars 1.26.18) | `3.0 Export to autouncle - part 1` `ek61rkico08` | **disabled**, no timing, nothing chains into it | one manual run 07.07.2026, aborted by user | `resources/autouncle-export/api_export_cars_autouncle.json` = 8 bytes (`{"ads":[`) |
-| | `3.1 Export to autouncle - part 2` `ek61ro0yv09` | **disabled**; shell `cp` of the JSON to `htdocs/autouncle/export_cars_autouncle.json` | never ran | `htdocs/autouncle/` does not exist |
-| DEV Cronicle (`auto-de-dev-cronicle-01`, 1.26.31) | `3.0 Export to Autouncle part1` `ek60tym7m0b` | enabled, no timing; chained from `2.1 Export facebook - part 2` | 10.09.2026, code 0 | 467 KB JSON of 10.09 (298 ads) |
-| | `3.1 Export to Autouncle part2` `ek60u1gsd0c` | enabled, chains to `ek87441xa04` | 10.09.2026, **code 1** every run (`cp: … htdocs/autouncle/… No such file or directory`) | — the rest of the DEV chain (criteo, meinestadt, ooyyo, …) stops here |
-
-PROD 3.0 params: `environment=production`, `String` = allow-list of 19 dealer `metaData.ownerId`s, `Number` =
-`metaData.imagesCount:2`. DEV 3.0: no rules. Both events were last modified 2023 (DEV) / 01.04.2026 (PROD,
-migration). Events, keys and scripts were read with `storage-cli list_get`, secrets redacted.
-
-Hosting: `https://scheduler.auto.de/autouncle/export_cars_autouncle.json` (historic) — no answer (timeout);
-`https://cronicle.auto.de/autouncle/…` and `http://cronicle.autode-dev.de/autouncle/…` — 404. Nothing is
-hosted for AutoUncle today, on any environment.
-
-## 2. Code path
-
-`ExportType.AUTOUNCLE = 'autouncle'` → `AutouncleConfig` + `AutouncleExporter` (`export.schema.ts`).
-
-Before (unchanged since the monorepo import 3046a15d, CO2 class ADV-187 b46e7e83):
-`emptyDir(resources/autouncle-export)` → for every car of the base export snapshot: shared `filterCar`
-(imagesCount > 0 + Cronicle rules) → UPA dealer profile (skip if none) → `AutouncleTransformer` →
-`AutouncleJsonBuilder` appends `{"ads":[…]}` directly to the published file.
-
-After (this branch): `AutouncleFeedRun` (`services/autouncle-feed-run.ts`) — lock → source snapshot check
-(shared ADV-335 `FeedGuard`) → per car: duplicate id, `filterCar`, car-level exclusions, dealer address (UPA,
-cached per dealer), clean images (ADV-336 `getCleanImages` + `ImageUrlValidator` + `selectOpenAiImageFields`)
-→ pure `mapAutouncleItem` → temp file → count check → atomic rename (`.prev` kept) → report.
-Dry-run is the default and writes `resources/autouncle-dryrun/`, which no Cronicle step reads.
-
-## 3. Field mapping (`ads[]`, keys/order/spellings unchanged)
-
-| Key | Source | Before | Now | Open |
-|---|---|---|---|---|
-| back_link | CBD `_id` | `https://www.<domain>/search/vehicle/<_id>?source=classifieds&medium=cpc&campaign=autouncle` | stable across runs; since 1.26.41 (ADV-324) `?source=autouncle&medium=listing&campaign=listing&utm_source=autouncle&utm_medium=listing&utm_campaign=listing` | pending AutoUncle approval → Q8 |
-| make / model_name / model_variant | mainData.make / model / subModel | raw | same | `SONSTIGE` placeholder models are exported (data) → Q9 |
-| fuel / body / gear_type | consumption.fuel / mainData.category / driveSuspension.gearbox | fixed maps; an unmapped or null selector made the key **disappear** from JSON | unmapped/null → `Other` / `other` | enum values → Q6 |
-| doors | mainData.doors | string | same | |
-| price | price.currentSalesPrice | `EUR <value>`; missing price → `"EUR "` and the car was still sent | same format; no valid positive price → car not sent (`no_valid_price`). Never a rate, never purchasePrice | currency format → Q6 |
-| year | mainData.firstRegistration (Unix s) | null → `moment(0)` → **1970** (143 of 1044 DEV cars) | missing/0/null/invalid → `""`; outside 1900..next year → `""` | null vs "" → Q6 |
-| status | same | `Neuwagen` only when firstRegistration === 0 | `Neuwagen` when no valid firstRegistration (same rule, null included) | 3 of 143 DEV cars are `condition=used` without registration → Q7 |
-| mileage | mainData.mileage | `<n>km`, 0 → `1km` | same | |
-| leasing / has_4wd | — | always `""` | same | → Q10 |
-| color | exterior.exteriorColor, German label | same | same | |
-| engine_size | engineData.cubicCapacity | `ccm` with no number when missing (189/1044) | `""` when missing | |
-| power | engineData.powerKW | kW, no unit | same | unit → Q6 |
-| seller_type / seller_name | — | `Dealer` / `auto.de` | same | marketplace vs dealer identity → Q3 |
-| seller_id | metaData.ownerId | **dealer** id already (not a vehicle id) | same; contract test with two cars of one dealer | |
-| seller_region / city / street_address / postcode | UPA businessAddress, else mainAddress; region from the postal code table | if the table did not know the place, street/city/zip were **blanked** (664/1044 DEV cars) | dealer's own values kept, region `Deutschland` | |
-| description | offer.offerDescription | raw | same; 192/1002 empty on DEV, some contain literal `\\` line breaks (dealer data) | → Q10 |
-| images | Imbo images | default profile: `/large` (format negotiated, can be WebP), padded with **3 noimage placeholders** below 17 photos (2820 placeholder URLs on DEV) | `[{url}]`, ADV-336 clean profile, explicit `large-cached.jpeg`, every URL checked (200 + image/jpeg|png); no valid 3/4 hero → car not sent | limits → ADV-323 gate |
-| fuel_economy / co2_emission | consumption.consumptionCombined / environmentEmissions.co2 | raw legacy fields; a BEV sent its kWh (CBD mirrors it into consumptionCombined) as fuel economy | since 1.26.41: the Google feed's EnVKV picks as plain numbers (WLTP first, legacy only as fallback; confirmed plug-in weighted); BEV: fuel `""`, CO₂ `0`; estimated values withheld by the publication gate (enforce) | units → Q6 |
-| co2_effiency_class | environmentEmissions.wltpEnergyEfficiencyClass (ADV-187) | raw | same; `""` when the CO₂ value is withheld (the class is derived from CO₂) | → Q6 |
-| euro_emission_class / enviromental_sticker | environmentEmissions.* | raw selector keys | same (no schema to translate to) | → Q6 |
-
-Car-level exclusions (new, counted in the report): `duplicate_id`, `filtered`, `no_id`, `no_dealer`,
-`reserved_or_sold` (offer.offerAvailability reserved/sold), `no_valid_price`, `no_valid_image`.
-
-## 4. Fixes on this branch
-
-1. Builder wrote the first car twice (`{"ads":[A,A,B…`) — fixed, test.
-2. Year 1970 for a null first registration (ACF-3717/3725 class of bug) — fixed, tests.
-3. Price must be a valid positive end-customer price, otherwise the car is not sent.
-4. Reserved / sold cars are not sent (absence = removal; partner semantics unknown → Q5).
-5. Dealer address no longer blanked when the postal code table misses the place.
-6. `engine_size` without a value is `""`, not `ccm`; unmapped selectors never drop a key.
-7. Images: clean profile + validator, no placeholders, no WebP risk, hero first (ADV-323).
-8. Fail-closed: no `emptyDir`; empty / partial / stale snapshot, empty result or a drop > 20 % against the
-   last good run → run blocked (exit 1, `3.1` copy does not run), last good file stays. Lock per state dir.
-9. Dry-run default; live only with `autouncleDryRun=false`.
-10. (1.26.41, 10.11) EnVKV: WLTP picks + EnVKV C8 publication gate (same params as the Google job). A live run
-    refuses to start without `publicationGate=enforce`. The run report has `envkv.estimated` for the two sent
-    attributes (fuel_consumption, co2_emissions; 1.26.42). DEV dry-run 10.11 (enforce): 1731 ads, estimated fuel 884 /
-    CO₂ 848 sent empty, 128 BEV with fuel "" and CO₂ 0, WLTP picks changed 338 fuel / 403 CO₂ values.
-11. (1.26.41, 10.11) `back_link` parameters per ADV-324 (partner in `source`, identical utm pair).
-
-## 5. Evidence
-
-- `npm test`: 138 ok (116 existing + 14 mapping + 8 run).
-- Other feeds byte-identical: `origin/deploy_develop` and this branch compiled with the same `node_modules`;
-  every emitted `.js` outside the AutoUncle files is identical (only `params.interface.d.ts` gains three
-  optional fields). Covers Google, FB/Meta, Criteo, meinestadt, OOYYO, OpenAI and the rest.
-- DEV dry-run 13.10.2026 (local, DEV snapshot 12.10 15:00 CEST, DEV `3.0` params): 2234 source cars →
-  1002 ads, 370 dealers, excluded `filtered` 1190 / `no_valid_image` 42, images 7259/7259 ok, 0 placeholders,
-  0 × 1970, 0 duplicate links. Old exporter on the same snapshot: 1045 ads (first duplicated), 143 × 1970,
-  2820 placeholder URLs. 20-car sample in `autouncle-sample/` (worktree, not committed).
-
-## 6. Not done / not decided
-
-- No partner schema, no test import, no activation, no Cronicle change, no version bump / publish.
-- `minPublishedItems` default is 1 (PROD exports an allow-list of 19 dealers; real size unknown) — set per job
-  before activation.
-- `3.1` copy target `htdocs/autouncle/` does not exist on either Cronicle; hosting/transport is a partner question (Q4).
-- Portrait / small images: the validator checks status + MIME only, no pixel size — waits for partner limits.
+# AutoUncle inventory feed — audit (ADV-322 / ADV-323)
+
+Status 13.10.2026, base `origin/deploy_develop` 3a025095, `@bytebrand/export-cars` 1.26.31.
+Historical documents (Confluence "autouncle [paused]", "2.7.2 Export Plugins", ACF-3604/3650/3717/3725/6172/6190)
+are evidence only. No current AutoUncle inventory schema is available; the public AutoUncle B2B
+"automotive API" is a dealer/DMS **valuation** API and is not used as a schema here.
+
+## 1. Is the export live? — No
+
+| Where | Event | State | Last run | Output |
+|---|---|---|---|---|
+| PROD Cronicle (`auto-de-prod-cronicle-01`, export-cars 1.26.18) | `3.0 Export to autouncle - part 1` `ek61rkico08` | **disabled**, no timing, nothing chains into it | one manual run 07.07.2026, aborted by user | `resources/autouncle-export/api_export_cars_autouncle.json` = 8 bytes (`{"ads":[`) |
+| | `3.1 Export to autouncle - part 2` `ek61ro0yv09` | **disabled**; shell `cp` of the JSON to `htdocs/autouncle/export_cars_autouncle.json` | never ran | `htdocs/autouncle/` does not exist |
+| DEV Cronicle (`auto-de-dev-cronicle-01`, 1.26.31) | `3.0 Export to Autouncle part1` `ek60tym7m0b` | enabled, no timing; chained from `2.1 Export facebook - part 2` | 10.09.2026, code 0 | 467 KB JSON of 10.09 (298 ads) |
+| | `3.1 Export to Autouncle part2` `ek60u1gsd0c` | enabled, chains to `ek87441xa04` | 10.09.2026, **code 1** every run (`cp: … htdocs/autouncle/… No such file or directory`) | — the rest of the DEV chain (criteo, meinestadt, ooyyo, …) stops here |
+
+PROD 3.0 params: `environment=production`, `String` = allow-list of 19 dealer `metaData.ownerId`s, `Number` =
+`metaData.imagesCount:2`. DEV 3.0: no rules. Both events were last modified 2023 (DEV) / 01.04.2026 (PROD,
+migration). Events, keys and scripts were read with `storage-cli list_get`, secrets redacted.
+
+Hosting: `https://scheduler.auto.de/autouncle/export_cars_autouncle.json` (historic) — no answer (timeout);
+`https://cronicle.auto.de/autouncle/…` and `http://cronicle.autode-dev.de/autouncle/…` — 404. Nothing is
+hosted for AutoUncle today, on any environment.
+
+## 2. Code path
+
+`ExportType.AUTOUNCLE = 'autouncle'` → `AutouncleConfig` + `AutouncleExporter` (`export.schema.ts`).
+
+Before (unchanged since the monorepo import 3046a15d, CO2 class ADV-187 b46e7e83):
+`emptyDir(resources/autouncle-export)` → for every car of the base export snapshot: shared `filterCar`
+(imagesCount > 0 + Cronicle rules) → UPA dealer profile (skip if none) → `AutouncleTransformer` →
+`AutouncleJsonBuilder` appends `{"ads":[…]}` directly to the published file.
+
+After (this branch): `AutouncleFeedRun` (`services/autouncle-feed-run.ts`) — lock → source snapshot check
+(shared ADV-335 `FeedGuard`) → per car: duplicate id, `filterCar`, car-level exclusions, dealer address (UPA,
+cached per dealer), clean images (ADV-336 `getCleanImages` + `ImageUrlValidator` + `selectOpenAiImageFields`)
+→ pure `mapAutouncleItem` → temp file → count check → atomic rename (`.prev` kept) → report.
+Dry-run is the default and writes `resources/autouncle-dryrun/`, which no Cronicle step reads.
+
+## 3. Field mapping (`ads[]`, keys/order/spellings unchanged)
+
+| Key | Source | Before | Now | Open |
+|---|---|---|---|---|
+| back_link | CBD `_id` | `https://www.<domain>/search/vehicle/<_id>?source=classifieds&medium=cpc&campaign=autouncle` | stable across runs; since 1.26.41 (ADV-324) `?source=autouncle&medium=listing&campaign=listing&utm_source=autouncle&utm_medium=listing&utm_campaign=listing` | pending AutoUncle approval → Q8 |
+| make / model_name / model_variant | mainData.make / model / subModel | raw | same | `SONSTIGE` placeholder models are exported (data) → Q9 |
+| fuel / body / gear_type | consumption.fuel / mainData.category / driveSuspension.gearbox | fixed maps; an unmapped or null selector made the key **disappear** from JSON | unmapped/null → `Other` / `other` | enum values → Q6 |
+| doors | mainData.doors | string | same | |
+| price | price.currentSalesPrice | `EUR <value>`; missing price → `"EUR "` and the car was still sent | same format; no valid positive price → car not sent (`no_valid_price`). Never a rate, never purchasePrice | currency format → Q6 |
+| year | mainData.firstRegistration (Unix s) | null → `moment(0)` → **1970** (143 of 1044 DEV cars) | missing/0/null/invalid → `""`; outside 1900..next year → `""` | null vs "" → Q6 |
+| status | same | `Neuwagen` only when firstRegistration === 0 | `Neuwagen` when no valid firstRegistration (same rule, null included) | 3 of 143 DEV cars are `condition=used` without registration → Q7 |
+| mileage | mainData.mileage | `<n>km`, 0 → `1km` | same | |
+| leasing / has_4wd | — | always `""` | same | → Q10 |
+| color | exterior.exteriorColor, German label | same | same | |
+| engine_size | engineData.cubicCapacity | `ccm` with no number when missing (189/1044) | `""` when missing | |
+| power | engineData.powerKW | kW, no unit | same | unit → Q6 |
+| seller_type / seller_name | — | `Dealer` / `auto.de` | same | marketplace vs dealer identity → Q3 |
+| seller_id | metaData.ownerId | **dealer** id already (not a vehicle id) | same; contract test with two cars of one dealer | |
+| seller_region / city / street_address / postcode | UPA businessAddress, else mainAddress; region from the postal code table | if the table did not know the place, street/city/zip were **blanked** (664/1044 DEV cars) | dealer's own values kept, region `Deutschland` | |
+| description | offer.offerDescription | raw | same; 192/1002 empty on DEV, some contain literal `\\` line breaks (dealer data) | → Q10 |
+| images | Imbo images | default profile: `/large` (format negotiated, can be WebP), padded with **3 noimage placeholders** below 17 photos (2820 placeholder URLs on DEV) | `[{url}]`, ADV-336 clean profile, explicit `large-cached.jpeg`, every URL checked (200 + image/jpeg|png); no valid 3/4 hero → car not sent | limits → ADV-323 gate |
+| fuel_economy / co2_emission | consumption.consumptionCombined / environmentEmissions.co2 | raw legacy fields; a BEV sent its kWh (CBD mirrors it into consumptionCombined) as fuel economy | since 1.26.41: the Google feed's EnVKV picks as plain numbers (WLTP first, legacy only as fallback; confirmed plug-in weighted); BEV: fuel `""`, CO₂ `0`; no filter, the stored values as in the Google / Meta feeds | units → Q6 |
+| co2_effiency_class | environmentEmissions.wltpEnergyEfficiencyClass (ADV-187) | raw | same | → Q6 |
+| euro_emission_class / enviromental_sticker | environmentEmissions.* | raw selector keys | same (no schema to translate to) | → Q6 |
+
+Car-level exclusions (new, counted in the report): `duplicate_id`, `filtered`, `no_id`, `no_dealer`,
+`reserved_or_sold` (offer.offerAvailability reserved/sold), `no_valid_price`, `no_valid_image`.
+
+## 4. Fixes on this branch
+
+1. Builder wrote the first car twice (`{"ads":[A,A,B…`) — fixed, test.
+2. Year 1970 for a null first registration (ACF-3717/3725 class of bug) — fixed, tests.
+3. Price must be a valid positive end-customer price, otherwise the car is not sent.
+4. Reserved / sold cars are not sent (absence = removal; partner semantics unknown → Q5).
+5. Dealer address no longer blanked when the postal code table misses the place.
+6. `engine_size` without a value is `""`, not `ccm`; unmapped selectors never drop a key.
+7. Images: clean profile + validator, no placeholders, no WebP risk, hero first (ADV-323).
+8. Fail-closed: no `emptyDir`; empty / partial / stale snapshot, empty result or a drop > 20 % against the
+   last good run → run blocked (exit 1, `3.1` copy does not run), last good file stays. Lock per state dir.
+9. Dry-run default; live only with `autouncleDryRun=false`.
+10. (1.26.41, 10.11) EnVKV: the Google feed's picks (WLTP first). DEV dry-run 10.11: 1731 ads, 128 BEV with fuel ""
+    and CO₂ 0, the WLTP picks changed 338 fuel / 403 CO₂ values against the legacy fields.
+    (1.26.43, 11.11) The EnVKV C8 publication gate of 1.26.41/42 was removed (user decision): like the Google and Meta
+    jobs, the feed sends the stored values without parameters. No `publicationGate*` params on this job.
+11. (1.26.41, 10.11) `back_link` parameters per ADV-324 (partner in `source`, identical utm pair).
+
+## 5. Evidence
+
+- `npm test`: 138 ok (116 existing + 14 mapping + 8 run).
+- Other feeds byte-identical: `origin/deploy_develop` and this branch compiled with the same `node_modules`;
+  every emitted `.js` outside the AutoUncle files is identical (only `params.interface.d.ts` gains three
+  optional fields). Covers Google, FB/Meta, Criteo, meinestadt, OOYYO, OpenAI and the rest.
+- DEV dry-run 13.10.2026 (local, DEV snapshot 12.10 15:00 CEST, DEV `3.0` params): 2234 source cars →
+  1002 ads, 370 dealers, excluded `filtered` 1190 / `no_valid_image` 42, images 7259/7259 ok, 0 placeholders,
+  0 × 1970, 0 duplicate links. Old exporter on the same snapshot: 1045 ads (first duplicated), 143 × 1970,
+  2820 placeholder URLs. 20-car sample in `autouncle-sample/` (worktree, not committed).
+
+## 6. Not done / not decided
+
+- No partner schema, no test import, no activation, no Cronicle change, no version bump / publish.
+- `minPublishedItems` default is 1 (PROD exports an allow-list of 19 dealers; real size unknown) — set per job
+  before activation.
+- `3.1` copy target `htdocs/autouncle/` does not exist on either Cronicle; hosting/transport is a partner question (Q4).
+- Portrait / small images: the validator checks status + MIME only, no pixel size — waits for partner limits.

package/docs/autouncle/RUNBOOK.md

@@ -15,8 +15,6 @@ Not activated. Nothing below has been done on any Cronicle host.
 | `feedGuardMaxSourceAgeHours` | 26 | newest base export chunk must be younger |
 | `feedGuardMaxStaleHours` | 48 | last good file reported STALE after this |
 | `feedGuardAcceptDrop` | off | `true` for ONE run after a real stock drop |
-| `publicationGate` | off | `audit` counts estimated EnVKV values, `enforce` sends them empty. **A live run needs `enforce`** (config error otherwise). enforce fails the run if the enrichment log cannot be read |
-| `publicationGateBqProject` / `…Dataset` / `…Table` | — | CBD enrichment log table, same values as the Google job; required for audit / enforce |
 
 `String` / `Number` rules stay as they are (PROD: dealer allow-list + `metaData.imagesCount:2`).
 

package/docs/meinestadt/AUDIT.md

@@ -46,8 +46,8 @@ only ones any partner export sends).
 | 2 | `make` | String | `mainData.make` | same | OK | OK |
 | 3 | `model` | String | `mainData.model` | same | placeholder `SONSTIGE` exists | sent as-is |
 | 4 | `cpc` | Float | literal `0,08` | `config.cpc` param, default **`'0.08'`** (string) | DEV event `cpc=0.99` | **BUG (ADV-325)**: hidden historical default; emitted as string |
-| 5 | `listingUrl` | String | `…/search/vehicle/<id>/?source=meineStadt&medium=cpc&campaign=listing` | `…/search/vehicle/<id>?source=classifieds&medium=listing&campaign=meinestadt` | — | UTM differs from sheet → ADV-327 (tracking, paused); unchanged |
-| 6 | `title` | String | make & model & subModel | `${make} ${model} ${subModel}` | — | `SONSTIGE` / `undefined` possible; not changed now |
+| 5 | `listingUrl` | String | `…/search/vehicle/<id>/?source=meineStadt&medium=cpc&campaign=listing` | `…/search/vehicle/<id>?source=classifieds&medium=listing&campaign=meinestadt` | — | **1.26.44**: `?source=meinestadt&medium=listing&campaign=listing` + identical `utm_*` (ADV-327, see §7) |
+| 6 | `title` | String | make & model & subModel | `${make} ${model} ${subModel}` | — | **1.26.44**: missing parts left out (no `undefined`); `SONSTIGE` still sent as-is |
 | 7 | `accidentFree` | Boolean | `mainData.accidentDamaged` | `accidentDamaged` **without inversion** | 697 `false`, 347 `null`, 0 `true` | **BUG (ADV-325)**: every known accident-free car is sent as `accidentFree:false` |
 | 8 | `city` | String | "do not include this field" | not emitted | — | OK (comply) |
 | 9 | `zip` | String | "do not include this field" | not emitted | — | OK |
@@ -61,8 +61,8 @@ only ones any partner export sends).
 | 17 | `numberOfPreviousOwners` | Number | `mainData.numberOfPreviousOwners` | same | 111 null | OK |
 | 18 | `price` | Number | `price.currentSalesPrice` | same | 1044 number | OK — end-customer purchase price (EUR), not a rate, not `price.purchasePrice` (dealer cost) |
 | 19 | `power` | Number | `engineData.powerPS`, "PS only" | `engineData.powerPS` | 1044; 6 cars where PS ≠ kW×1.36 (source data) | OK — PS, not kW |
-| 20 | `co2Emissions` | Number | `environmentEmissions.co2` | same | OK | OK |
-| 21 | `fuelConsumptionCombined` | Float | `consumption.consumptionCombined` | same | OK | OK |
+| 20 | `co2Emissions` | Number | `environmentEmissions.co2` | same | OK | **1.26.44**: Google feed EnVKV pick (WLTP first, legacy fallback; BEV 0), null when none |
+| 21 | `fuelConsumptionCombined` | Float | `consumption.consumptionCombined` | same | OK | **1.26.44**: Google feed EnVKV pick; BEV null (CBD mirrors kWh into `consumptionCombined`) |
 | 22 | `images` | **String Array** | "put image url of main image … not the image id" | `carImages[0]` → a **single string** | — | **BUG (ADV-326)**: not an array; first entry of a placeholder-padded list |
 | 23 | `equipment` | String Array / comma string (`"ABS, Klimaanlage, DAB"`) | `offer.offerDescription` | mobile.de description (markdown `**`, `\\`, dealer header/footer) | — | differs from sheet; partner question, not changed now |
 | 24 | `color` | String (DE) | `exterior.exteriorColor` | `de[...]` | e.g. `Rot` | OK |
@@ -144,3 +144,19 @@ marketing header/footer of the mobile.de description ("über 180.000 Autos …")
 ## 6. Open partner questions
 
 See `PARTNER-QUESTIONS.md`.
+
+## 7. Round 2 — export-cars 1.26.44 (12.11.2026, DEV only)
+
+Same follow-ups as the AutoUncle feed got in 1.26.41–1.26.43 (ADV-322/324), no parameters added:
+
+- `co2Emissions` / `fuelConsumptionCombined`: the Google feed's EnVKV picks (`envkvCo2Value`,
+  `envkvFuelConsumptionValue`): WLTP first, legacy only as fallback, confirmed plug-in weighted; a BEV sends
+  no fuel consumption (`null`, CBD mirrors its kWh into `consumptionCombined`) and CO2 `0`. Nothing usable → `null`.
+  Stored values are sent like in the Google / Meta feeds (no publication gate).
+- `listingUrl` (ADV-327): `?source=meinestadt&medium=listing&campaign=listing&utm_source=meinestadt&utm_medium=listing&utm_campaign=listing`.
+  Partner in `source` so the reporting views, the CRM source and GA4 all see meinestadt; no paid medium (CPC is a
+  contract attribute). web-funnel-tracking-health 1.5.5 books it (and the legacy `source=classifieds&campaign=meinestadt`
+  and the sheet's `source=meineStadt&medium=cpc`) as `CLASSIFIEDS_MEINESTADT`, family Classifieds. Pending meinestadt's OK.
+- `title`: make / model / subModel without missing parts (was `"… undefined"` when subModel is missing).
+- Unchanged: keys, order, file names, envelope, dry-run default, images (ADV-326 tests incl. 8 raw / 1 valid → `imagesCount` 1).
+

package/docs/meinestadt/PARTNER-QUESTIONS.md

@@ -32,7 +32,7 @@ only — we need the CURRENT automotive specification in writing.
     `transmissionType`, `emissionClass`, `emissionSticker`, `usageState`, `customerType`?
 12. `power`: confirm PS (not kW). `price`: confirm gross EUR purchase price.
 13. Location: our historical mapping says not to send `city`, `zip`, `latitude`, `longitude`. Still correct?
-14. `listingUrl`: required tracking parameters (historical: `source=meineStadt&medium=cpc&campaign=listing`)?
+14. `listingUrl`: required tracking parameters (historical: `source=meineStadt&medium=cpc&campaign=listing`)? DEV feed since 1.26.44 sends `source=meinestadt&medium=listing&campaign=listing` + the same `utm_*` values — OK for you?
 
 ## Images
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytebrand/export-cars",
-  "version": "1.26.42",
+  "version": "1.26.44",
   "description": "",
   "author": "bytebrand",
   "license": "UNLICENSED",

package/src/configs/autouncle.config.ts

@@ -1,7 +1,7 @@
 import { toNumber } from 'lodash';
 
 import { ExportType, FileType, ImageType } from '../enums';
-import { Params, PublicationGateConfig } from '../interfaces/params.interface';
+import { Params } from '../interfaces/params.interface';
 import { FeedGuardOptions } from '../services/feed-guard';
 import { Config } from './config';
 
@@ -55,33 +55,8 @@ export class AutouncleConfig extends Config {
       maxStaleHours: positiveNumber(params.feedGuardMaxStaleHours, AUTOUNCLE_DEFAULTS.maxStaleHours),
       acceptDrop: text(params.feedGuardAcceptDrop).toLowerCase() === 'true',
     };
-    this.publicationGate = parsePublicationGate(params);
-    // ADV-322 "do not guess emissions": a live file never goes out with unchecked EnVKV estimates.
-    if (!this.dryRun && this.publicationGate?.mode !== 'enforce') {
-      throw new Error('a live AutoUncle run (autouncleDryRun=false) needs publicationGate=enforce');
-    }
     this.outputFiles = [
       `${this.pathesConfig.localConvertedDirectory}/api_export_cars_${ExportType.AUTOUNCLE}.${FileType.JSON}`,
     ];
   }
 }
-
-// Same params and rules as the Google job (GoogleConfig): off by default; audit / enforce need the
-// enrichment log table (publicationGateBqProject / Dataset / Table).
-function parsePublicationGate(params: Params): PublicationGateConfig | undefined {
-  const mode = text(params.publicationGate).toLowerCase();
-  if (!mode || mode === 'off') return undefined;
-  if (mode !== 'audit' && mode !== 'enforce') {
-    throw new Error(`publicationGate must be off, audit or enforce, got "${mode}"`);
-  }
-  const gate = {
-    mode: mode as PublicationGateConfig['mode'],
-    project: text(params.publicationGateBqProject),
-    dataset: text(params.publicationGateBqDataset),
-    table: text(params.publicationGateBqTable),
-  };
-  if (!gate.project || !gate.dataset || !gate.table) {
-    throw new Error(`publicationGate=${mode} needs publicationGateBqProject, publicationGateBqDataset and publicationGateBqTable`);
-  }
-  return gate;
-}

package/src/exporters/autouncle.exporter.ts

@@ -9,7 +9,6 @@ import { resolveOpenAiImageFields } from '../transformers/openai-image-fields';
 import { CarService, RulesService, LoaderService, ConfigService, ImagesService } from '../services';
 import { ImageUrlValidator } from '../services/image-url-validator.service';
 import { FeedGuard } from '../services/feed-guard';
-import { PublicationGate, loadPublicationGate } from '../services/publication-gate';
 import { AutouncleFeedRun, AutouncleSourceCar } from '../services/autouncle-feed-run';
 import { AutouncleConfig } from '../configs/autouncle.config';
 import { Exporter } from '../interfaces/exporter.interface';
@@ -37,16 +36,6 @@ export class AutouncleExporter implements Exporter {
     const transformer = await this.moduleRef.create(AutouncleTransformer);
     const addresses = new Map<string, Promise<AutouncleAddress | null>>();
 
-    // EnVKV C8 (ADV-322): estimated values are withheld (enforce) or only counted (audit). enforce fails
-    // the job when the enrichment log cannot be read, so the last published file stays.
-    let gate: PublicationGate;
-    try {
-      gate = await loadPublicationGate(config.publicationGate);
-    } catch (error) {
-      LoggerService.exitError(`autouncle feed not published: ${error?.message ?? error}`);
-      process.exit(1);
-    }
-
     const run = new AutouncleFeedRun(
       {
         forEachChunk: fn => this.loaderService.process((chunk: FsChunkInterface) => fn(chunk.data as AutouncleSourceCar[])),
@@ -66,7 +55,6 @@ export class AutouncleExporter implements Exporter {
         imageStats: () => validator.stats,
         translate: key => transformer.translate(key),
         guard: new FeedGuard(config.feedGuard),
-        gate,
       },
       {
         runId: config.runId,

package/src/interfaces/export-item.interface.ts

@@ -88,8 +88,9 @@ export interface MeinstadtJsonItem {
   price: number;
   // PS
   power: number;
-  co2Emissions: number;
-  fuelConsumptionCombined: number;
+  // EnVKV picks (as Google), null when nothing usable
+  co2Emissions: number | null;
+  fuelConsumptionCombined: number | null;
   equipment: string;
   color: string;
   bodyType: string;

package/src/services/autouncle-feed-run.ts

@@ -4,11 +4,8 @@ import { ImboImageResponseInterface } from '@bytebrand/chunkable';
 import { DataSchemes } from '@bytebrand/car-schema';
 
 import { AutouncleJsonBuilder } from '../formats/autouncle-json.builder';
-import {
-  AUTOUNCLE_ENVKV_ATTRIBUTES, AutouncleAddress, AutouncleExclusion, getAutouncleExclusion, mapAutouncleItem,
-} from '../transformers/autouncle.transformer';
+import { AutouncleAddress, AutouncleExclusion, getAutouncleExclusion, mapAutouncleItem } from '../transformers/autouncle.transformer';
 import { FeedGuard, FeedGuardError, LastGood, inspectSourceSnapshot } from './feed-guard';
-import { PublicationGate } from './publication-gate';
 
 export interface AutouncleSourceCar {
   car: DataSchemes.Car;
@@ -29,8 +26,6 @@ export interface AutouncleRunDeps {
   imageStats: () => Record<string, number>;
   translate: (key: string) => string;
   guard: FeedGuard;
-  // EnVKV C8 publication gate (CBD enrichment log); absent = off
-  gate?: Pick<PublicationGate, 'mode' | 'estimatedAttributes'>;
 }
 
 export interface AutouncleRunOptions {
@@ -59,8 +54,6 @@ export interface AutouncleRunReport {
   excluded: Record<string, number>;
   imagesPerItem: { min: number | null; max: number | null; total: number };
   images: Record<string, number>;
-  // published items with an estimated EnVKV value per attribute; with gate enforce those were sent empty
-  envkv: { gate: 'off' | 'audit' | 'enforce'; estimated: Record<string, number> };
   lastGood: LastGood | null;
   lastGoodAgeHours: number | null;
   stale: boolean;
@@ -100,7 +93,6 @@ export class AutouncleFeedRun {
       excluded: {},
       imagesPerItem: { min: null, max: null, total: 0 },
       images: {},
-      envkv: { gate: this.deps.gate?.mode ?? 'off', estimated: {} },
       lastGood,
       lastGoodAgeHours: guard.staleHours(lastGood, startedAt),
       stale: guard.isStale(lastGood, startedAt),
@@ -149,20 +141,11 @@ export class AutouncleFeedRun {
             continue;
           }
           const images = await this.deps.resolveImages(source);
-          const estimated = (this.deps.gate ? this.deps.gate.estimatedAttributes(source.car) : [])
-            .filter(attribute => AUTOUNCLE_ENVKV_ATTRIBUTES.includes(attribute));
-          const mapped = mapAutouncleItem(source.car, {
-            domain: this.options.domain,
-            address,
-            images,
-            translate: this.deps.translate,
-            withheldEnvkv: this.deps.gate?.mode === 'enforce' ? estimated : [],
-          });
+          const mapped = mapAutouncleItem(source.car, { domain: this.options.domain, address, images, translate: this.deps.translate });
           if (mapped.ok === false) {
             increment(report.excluded, mapped.reason);
             continue;
           }
-          estimated.forEach(attribute => increment(report.envkv.estimated, attribute));
           await builder.addItem(mapped.item, first);
           first = false;
           dealers.add(ownerId);

package/src/transformers/autouncle.transformer.ts

@@ -11,7 +11,7 @@ import { DEFAULT_REGION, MIN_MILEAGES } from '../constants/autouncle.contants';
 import { AutouncleJsonItem } from '../interfaces';
 import { OpenAiImageSelection } from './openai-image-fields';
 import { toUnixSeconds } from './meinstadt.transformer';
-import { GoogleEnvkvAttribute, envkvCo2Value, envkvFuelConsumptionValue } from './google-feed-envkv';
+import { envkvCo2Value, envkvFuelConsumptionValue } from './google-feed-envkv';
 
 // back_link parameters (ADV-324): the partner in `source`, so the reporting views, the CRM source and
 // GA4 (utm_*) all see "autouncle". Legacy and utm pairs carry identical values (no parameterConflict).
@@ -19,9 +19,6 @@ import { GoogleEnvkvAttribute, envkvCo2Value, envkvFuelConsumptionValue } from '
 export const AUTOUNCLE_LINK_PARAMS =
   'source=autouncle&medium=listing&campaign=listing&utm_source=autouncle&utm_medium=listing&utm_campaign=listing';
 
-// The EnVKV attributes the feed sends (fuel_economy, co2_emission); the gate knows more (range, kWh, …).
-export const AUTOUNCLE_ENVKV_ATTRIBUTES: GoogleEnvkvAttribute[] = ['fuel_consumption', 'co2_emissions'];
-
 export enum AutouncleExclusion {
   duplicateId = 'duplicate_id',
   filtered = 'filtered',
@@ -49,8 +46,6 @@ export interface AutouncleMappingContext {
   images: string[];
   // German label of a selector (TranslatorExtended.translateVal)
   translate: (key: string) => string;
-  // EnVKV attributes whose value is a CBD estimate and must not be published (publication gate, enforce)
-  withheldEnvkv?: GoogleEnvkvAttribute[];
 }
 
 export type AutouncleMapResult = { ok: true; item: AutouncleJsonItem } | { ok: false; reason: AutouncleExclusion };
@@ -191,10 +186,6 @@ export const mapAutouncleItem = (car: DataSchemes.Car, ctx: AutouncleMappingCont
   const sellerId = toString(get(car, 'metaData.ownerId', '')).trim();
   const price = getAutounclePrice(get(car, 'price.currentSalesPrice', null));
   const firstRegistration = get(car, 'mainData.firstRegistration', null);
-  // EnVKV (ADV-322): the WLTP picks of the Google feed (legacy fields only as their fallback), never an
-  // estimated value. The energy class is derived from CO2, so it goes with a withheld CO2 value.
-  const withheld = ctx.withheldEnvkv ?? [];
-  const co2Withheld = withheld.includes('co2_emissions');
 
   return {
     ok: true,
@@ -226,10 +217,12 @@ export const mapAutouncleItem = (car: DataSchemes.Car, ctx: AutouncleMappingCont
       seller_id: sellerId,
       description: toString(get(car, 'offer.offerDescription', '')),
       images: ctx.images.map(url => ({ url })),
-      fuel_economy: withheld.includes('fuel_consumption') ? '' : toString(envkvFuelConsumptionValue(car) ?? ''),
-      co2_emission: co2Withheld ? '' : toString(envkvCo2Value(car) ?? ''),
+      // EnVKV (ADV-322): the same values as the Google feed (WLTP first, legacy only as fallback; BEV: no
+      // fuel, CO2 0), as plain numbers.
+      fuel_economy: toString(envkvFuelConsumptionValue(car) ?? ''),
+      co2_emission: toString(envkvCo2Value(car) ?? ''),
       // ADV-187: canonical CO2-derived WLTP class, not the unvalidated legacy NEFZ class.
-      co2_effiency_class: co2Withheld ? '' : toString(get(car, 'environmentEmissions.wltpEnergyEfficiencyClass', '')),
+      co2_effiency_class: toString(get(car, 'environmentEmissions.wltpEnergyEfficiencyClass', '')),
       euro_emission_class: toString(get(car, 'environmentEmissions.emissionClass', '')),
       enviromental_sticker: toString(get(car, 'environmentEmissions.emissionSticker', '')),
     },

package/src/transformers/meinstadt.transformer.ts

@@ -9,6 +9,21 @@ import { de } from '@bytebrand/i18n-dictionaries';
 import { UserService } from '../services';
 import { MeinstadtJsonItem } from '../interfaces';
 import { OpenAiImageSelection } from './openai-image-fields';
+import { envkvCo2Value, envkvFuelConsumptionValue } from './google-feed-envkv';
+
+// listingUrl parameters (ADV-327, same scheme as AutoUncle ADV-324): the partner in `source`, so the
+// reporting views, the CRM source and GA4 (utm_*) all see "meinestadt". Legacy and utm pairs carry
+// identical values; paid / unpaid (CPC) is a contract attribute and is not encoded in the medium.
+export const MEINSTADT_LINK_PARAMS =
+  'source=meinestadt&medium=listing&campaign=listing&utm_source=meinestadt&utm_medium=listing&utm_campaign=listing';
+
+// make, model, subModel joined; missing parts are left out (never the text "undefined" / "null").
+export const getMeinstadtTitle = (car: DataSchemes.Car): string =>
+  ['mainData.make', 'mainData.model', 'mainData.subModel']
+    .map(path => get(car, path, null))
+    .filter(part => typeof part === 'string' && part.trim())
+    .map(part => part.trim())
+    .join(' ');
 
 /**
  * The meinestadt `images` list from the shared validated clean selection (ADV-336, same rules as
@@ -96,8 +111,8 @@ export const mapMeinstadtItem = (car: DataSchemes.Car, ctx: MeinstadtMappingCont
     make: get(car, 'mainData.make', null),
     model: get(car, 'mainData.model', null),
     cpc: ctx.cpc,
-    listingUrl: `https://www.${ctx.domain}/search/vehicle/${carId}?source=classifieds&medium=listing&campaign=meinestadt`,
-    title: `${car.mainData.make} ${car.mainData.model} ${car.mainData.subModel}`,
+    listingUrl: `https://www.${ctx.domain}/search/vehicle/${carId}?${MEINSTADT_LINK_PARAMS}`,
+    title: getMeinstadtTitle(car),
     accidentFree: toAccidentFree(get(car, 'mainData.accidentDamaged', null)),
     mileage: get(car, 'mainData.mileage', null),
     initialRegistration: toUnixSeconds(get(car, 'mainData.firstRegistration', null)),
@@ -109,8 +124,10 @@ export const mapMeinstadtItem = (car: DataSchemes.Car, ctx: MeinstadtMappingCont
     price: get(car, 'price.currentSalesPrice', null),
     // PS, not kW (workbook: "only put the value for PS")
     power: get(car, 'engineData.powerPS', null),
-    co2Emissions: get(car, 'environmentEmissions.co2', null),
-    fuelConsumptionCombined: get(car, 'consumption.consumptionCombined', null),
+    // EnVKV: the same values as the Google / AutoUncle feeds (WLTP first, legacy only as fallback;
+    // BEV: no fuel consumption, CO2 0). Nothing usable -> null.
+    co2Emissions: envkvCo2Value(car) ?? null,
+    fuelConsumptionCombined: envkvFuelConsumptionValue(car) ?? null,
     equipment: ctx.equipment,
     color: translate(get(car, 'exterior.exteriorColor', null)),
     bodyType: translate(get(car, 'mainData.category', null)),

package/test/autouncle-feed-run.test.ts

@@ -7,7 +7,7 @@ import { tmpdir } from 'os';
 import { join } from 'path';
 
 import { FeedGuard, FeedGuardError, FeedGuardOptions } from '../src/services/feed-guard';
-import { AutouncleFeedRun, AutouncleRunDeps, AutouncleSourceCar } from '../src/services/autouncle-feed-run';
+import { AutouncleFeedRun, AutouncleSourceCar } from '../src/services/autouncle-feed-run';
 import { toAutouncleImages } from '../src/transformers/autouncle.transformer';
 import { selectOpenAiImageFields } from '../src/transformers/openai-image-fields';
 import { buildImagesService } from './fixtures/images-service.harness';
@@ -63,9 +63,7 @@ const guardOptions = (world: World, extra: Partial<FeedGuardOptions> = {}): Feed
   ...extra,
 });
 
-type Gate = AutouncleRunDeps['gate'];
-
-const run = async (world: World, { at = NOW, guard = {}, gate }: { at?: Date; guard?: Partial<FeedGuardOptions>; gate?: Gate } = {}) => {
+const run = async (world: World, { at = NOW, guard = {} }: { at?: Date; guard?: Partial<FeedGuardOptions> } = {}) => {
   const forEachChunk = async (fn: (cars: AutouncleSourceCar[]) => Promise<void>) => {
     const names = (await fs.readdir(world.source)).sort((a, b) => Number(a.split('.')[1]) - Number(b.split('.')[1]));
     for (const name of names) {
@@ -87,7 +85,6 @@ const run = async (world: World, { at = NOW, guard = {}, gate }: { at?: Date; gu
       imageStats: () => ({ ok: 1 }),
       translate: key => key,
       guard: new FeedGuard(guardOptions(world, guard)),
-      gate,
     },
     {
       runId: 'test',
@@ -234,26 +231,6 @@ const tests: Array<[string, () => Promise<void>]> = [
     assert.equal(await exists(world.json), false);
   }],
 
-  ['EnVKV gate: enforce sends estimated values empty, audit only counts them; off without a gate', async () => {
-    const world = await newWorld();
-    await writeSource(world, [source('v1'), source('v2')]);
-    // v1: the CO2 value it would send is a CBD estimate; the range is too, but the feed has no range key
-    const estimatedAttributes = (c: any): any[] => (c._id === 'v1' ? ['co2_emissions', 'electric_range'] : []);
-
-    const off = await run(world);
-    assert.deepEqual(off.envkv, { gate: 'off', estimated: {} });
-
-    const audit = await run(world, { at: new Date(NOW.getTime() + HOUR), gate: { mode: 'audit', estimatedAttributes } });
-    assert.deepEqual(audit.envkv, { gate: 'audit', estimated: { co2_emissions: 1 } });
-    assert.deepEqual((await readAds(world)).map((a: any) => a.co2_emission), ['137', '137']);
-
-    const enforce = await run(world, { at: new Date(NOW.getTime() + 2 * HOUR), gate: { mode: 'enforce', estimatedAttributes } });
-    assert.deepEqual(enforce.envkv, { gate: 'enforce', estimated: { co2_emissions: 1 } });
-    const ads = await readAds(world);
-    assert.deepEqual(ads.map((a: any) => [a.co2_emission, a.fuel_economy]), [['', '6.1'], ['137', '6.1']]);
-    assert.equal(ads.length, 2, 'a withheld value never drops the car');
-  }],
-
   ['second run with the same snapshot: byte-identical file (stable ids, order, links)', async () => {
     const world = await newWorld();
     await writeSource(world, [source('i1'), source('i2'), source('i3')]);