fix(spec): the served export door answers CSV, JSON or XLSX, not the ExportFormat set

GET /api/v1/data/:object/export reads its own format (csv | json | xlsx,
anything else falling back to csv); ExportFormat also declares jsonl and
parquet. The retirement prose (module docblock, section note, D3 entry,
changeset) no longer ties the served door to ExportFormat.

Co-authored-by: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Rjy9MeetSfq34PKn81CRiN

Author: claude

.changeset/17158-export-job-family-retired.md

@@ -12,7 +12,7 @@ A `major`-class change, recorded as `minor` under the launch-window convention.
 
 | removed | from | what to write instead |
 | --- | --- | --- |
-| `ExportJobStatus`, `CreateExportJobRequestSchema` / `CreateExportJobResponseSchema`, `ExportJobProgressSchema` (with their types and `…Parsed` aliases) | `@objectstack/spec/api` | nothing — no route ever created or tracked an export job. To export records, call the served synchronous door `GET /api/v1/data/:object/export` (the SDK's `data.export`), which answers the file itself; its format vocabulary is `ExportFormat`, which stays. |
+| `ExportJobStatus`, `CreateExportJobRequestSchema` / `CreateExportJobResponseSchema`, `ExportJobProgressSchema` (with their types and `…Parsed` aliases) | `@objectstack/spec/api` | nothing — no route ever created or tracked an export job. To export records, call the served synchronous door `GET /api/v1/data/:object/export` (the SDK's `data.export`), which answers the file itself as CSV, JSON or XLSX. |
 | `GetExportJobDownloadRequestSchema` / `GetExportJobDownloadResponseSchema`, `ListExportJobsRequestSchema` / `ListExportJobsResponseSchema`, `ExportJobSummarySchema` (with their types and `…Parsed` aliases) | `@objectstack/spec/api` | nothing — no job ever existed to download or list. |
 | `ScheduledExportSchema`, `ScheduleExportRequestSchema` / `ScheduleExportResponseSchema` (with their types and `…Parsed` aliases) | `@objectstack/spec/api` | a `Job` (`system/job.zod.ts`) whose handler performs the export, with its cadence on `Job.schedule.expression` — the one cron slot the platform evaluates. |
 | `ExportApiContracts` | `@objectstack/spec/api` | nothing — every route it named was unserved. |

packages/spec/src/api/export-job-family-retirement.test.ts

@@ -90,7 +90,7 @@ const RETIRED_DEFS = [
 
 const SEMANTIC_ID = 'export-job-family-retired';
 
-/** Same-module neighbours that stay — the served import-job family and the format vocabulary. */
+/** Same-module neighbours that stay — the served import-job family, and the template shape with its format enum. */
 const MUST_SURVIVE_API = [
   'ExportFormat', 'ExportImportTemplateSchema', 'ImportJobStatus', 'ImportJobProgressSchema',
   'ListImportJobsRequestSchema', 'ListImportJobsResponseSchema', 'ImportJobApiContracts',

packages/spec/src/api/export.zod.ts

@@ -13,8 +13,8 @@ import { BaseResponseSchema } from './contract.zod';
  * Dynamics 365 Data Management.
  *
  * The export the platform serves is the synchronous streaming door
- * `GET /api/v1/data/:object/export`, which answers the file itself in one of
- * the `ExportFormat` formats. The asynchronous export-job API that used to be
+ * `GET /api/v1/data/:object/export`, which answers the file itself as CSV,
+ * JSON or XLSX. The asynchronous export-job API that used to be
  * declared here (export jobs, their progress / download / list shapes,
  * scheduled exports and `ExportApiContracts`) was never served by any route and
  * was removed in @objectstack/spec 17 (ADR-0049 enforce-or-remove); a recurring
@@ -59,9 +59,10 @@ export type ExportFormat = z.input<typeof ExportFormat>;
  * `export-job-family-retired` carries the prescription.
  *
  * The export that IS served is the synchronous streaming door
- * `GET /api/v1/data/:object/export` (`@objectstack/rest`), whose file format
- * vocabulary is `ExportFormat` above. A recurring export is a `Job` whose
- * handler you write (`Job.schedule.expression`, `system/job.zod.ts`).
+ * `GET /api/v1/data/:object/export` (`@objectstack/rest`), which answers CSV,
+ * JSON or XLSX (its own `format` read, not `ExportFormat` above). A recurring
+ * export is a `Job` whose handler you write (`Job.schedule.expression`,
+ * `system/job.zod.ts`).
  */
 
 // ==========================================

packages/spec/src/migrations/entries/semantic/18.export-job-family-retired.ts

@@ -22,8 +22,8 @@ export const entry: SemanticMigration = {
     'nothing to re-declare for the job family — no route ever served it, so no caller holds '
     + 'a job id, a progress body or a download link to carry over. The export the platform '
     + 'DOES serve is the synchronous streaming door GET /api/v1/data/:object/export '
-    + '(@objectstack/rest, the SDK method data.export): it answers the file itself in the '
-    + 'requested format, and its format vocabulary is ExportFormat, which stays published. '
+    + '(@objectstack/rest, the SDK method data.export): it answers the file itself as CSV, '
+    + 'JSON or XLSX. ExportFormat stays published (ExportImportTemplate still references it). '
     + 'A recurring export is a Job (system/job.zod.ts) whose handler you write, with its '
     + 'cadence on Job.schedule.expression — the one cron slot the platform evaluates. A '
     + 'scheduled flow declares its cadence on its start node (config.schedule), and its run '

packages/spec/src/migrations/registry.ts

@@ -8387,8 +8387,8 @@ const step18: MigrationStep = {
         'nothing to re-declare for the job family — no route ever served it, so no caller holds '
         + 'a job id, a progress body or a download link to carry over. The export the platform '
         + 'DOES serve is the synchronous streaming door GET /api/v1/data/:object/export '
-        + '(@objectstack/rest, the SDK method data.export): it answers the file itself in the '
-        + 'requested format, and its format vocabulary is ExportFormat, which stays published. '
+        + '(@objectstack/rest, the SDK method data.export): it answers the file itself as CSV, '
+        + 'JSON or XLSX. ExportFormat stays published (ExportImportTemplate still references it). '
         + 'A recurring export is a Job (system/job.zod.ts) whose handler you write, with its '
         + 'cadence on Job.schedule.expression — the one cron slot the platform evaluates. A '
         + 'scheduled flow declares its cadence on its start node (config.schedule), and its run '