Skip to content

Commit 583fce4

Browse files
committed
docs(spec): regenerate the package-lifecycle reference for the served withheldMaps describe
Claude-Session: https://claude.ai/code/session_01JQwxbYXRMR5S5B7JSmKkV7 Co-authored-by: Claude <noreply@anthropic.com>
1 parent eed1639 commit 583fce4

1 file changed

Lines changed: 6 additions & 7 deletions

File tree

‎content/docs/references/api/package-lifecycle.mdx‎

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -43,12 +43,11 @@ declared a VERSION rollback against the live COMMIT-rollback path;
4343
`RollbackToPackageCommitResponseSchema` below is the true contract,
4444
authored after that retirement per the ruling's sequencing (3A).
4545

46-
Two members are not transcriptions but DECLARED AHEAD OF THEIR PRODUCER
47-
(ADR-0049), each describe opening `[PLANNED — not yet served]` until the
46+
One member is not a transcription but DECLARED AHEAD OF ITS PRODUCER
47+
(ADR-0049), its describe opening `[PLANNED — not yet served]` until the
4848
change that serves it drops the marker: the `nav` arm of
49-
`GetPackageCustomizationsResponseSchema.contributions` (#27928) and
50-
`PackageExportManifestSchema.withheldMaps` (#28640 ruling ③A, served by
51-
#29342). Their own docblocks say what is not served yet.
49+
`GetPackageCustomizationsResponseSchema.contributions` (#27928). Its own
50+
docblock says what is not served yet.
5251

5352
<Callout type="info">
5453
**Source:** `packages/spec/src/api/package-lifecycle.zod.ts`
@@ -333,7 +332,7 @@ A field or flow another package contributes to one of the base's objects.
333332
| **name** | `string` | ✅ | The exported package's machine name. |
334333
| **version** | `string` | ✅ | The exported package's version. |
335334
| **label** | `string` | optional | Display label, when the package declares one. |
336-
| **withheldMaps** | `{ type: 'connector'; name: string; path: Enum<'providerConfig.headers' \| 'providerConfig.defaultHeaders' \| …> }[]` | optional | [PLANNED — not yet served] Declared ahead of its producer (ADR-0049): no export writes this list yet and no install door reads it yet. Every map the export withheld WHOLE because a served read never carries it: a connector's header and environment-variable maps. The item is written with that map absent, so once served an import reads this list to tell an incomplete map from one the package never had, and names each one for an operator to re-enter. Positions only: no header or variable name is listed. Absence says nothing about what was withheld when the exporter predates this key; from an exporter that writes it, absence means nothing was withheld. |
335+
| **withheldMaps** | `{ type: 'connector'; name: string; path: Enum<'providerConfig.headers' \| 'providerConfig.defaultHeaders' \| …> }[]` | optional | Every map the export withheld WHOLE because a served read never carries it: a connector's header and environment-variable maps. The item is written with that map absent, so an import reads this list to tell an incomplete map from one the package never had, and names each one for an operator to re-enter. Positions only: no header or variable name is listed. Absence says nothing about what was withheld when the exporter predates this key; from an exporter that writes it, absence means nothing was withheld. |
337336

338337

339338
---
@@ -348,7 +347,7 @@ A field or flow another package contributes to one of the base's objects.
348347
| **name** | `string` | ✅ | The exported package's machine name. |
349348
| **version** | `string` | ✅ | The exported package's version. |
350349
| **label** | `string` | optional | Display label, when the package declares one. |
351-
| **withheldMaps** | `{ type: 'connector'; name: string; path: Enum<'providerConfig.headers' \| 'providerConfig.defaultHeaders' \| …> }[]` | optional | [PLANNED — not yet served] Declared ahead of its producer (ADR-0049): no export writes this list yet and no install door reads it yet. Every map the export withheld WHOLE because a served read never carries it: a connector's header and environment-variable maps. The item is written with that map absent, so once served an import reads this list to tell an incomplete map from one the package never had, and names each one for an operator to re-enter. Positions only: no header or variable name is listed. Absence says nothing about what was withheld when the exporter predates this key; from an exporter that writes it, absence means nothing was withheld. |
350+
| **withheldMaps** | `{ type: 'connector'; name: string; path: Enum<'providerConfig.headers' \| 'providerConfig.defaultHeaders' \| …> }[]` | optional | Every map the export withheld WHOLE because a served read never carries it: a connector's header and environment-variable maps. The item is written with that map absent, so an import reads this list to tell an incomplete map from one the package never had, and names each one for an operator to re-enter. Positions only: no header or variable name is listed. Absence says nothing about what was withheld when the exporter predates this key; from an exporter that writes it, absence means nothing was withheld. |
352351

353352
### Nested Shape: `PackageExportManifest.withheldMaps[number]`
354353

0 commit comments

Comments
 (0)