Skip to content

Commit 0b5e632

Browse files
committed
docs(spec): regenerate the package-lifecycle reference after merging main
Claude-Session: https://claude.ai/code/session_01JQwxbYXRMR5S5B7JSmKkV7 Co-authored-by: Claude <noreply@anthropic.com>
1 parent 009c0b7 commit 0b5e632

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`
@@ -335,7 +334,7 @@ A field or flow another package contributes to one of the base's objects.
335334
| **namespace** | `string` | optional | The namespace the package was installed with, as its registry row's manifest declares it; absent when the row declares none. An install of the export keeps it instead of deriving one from the id, so a `.custom` pair is reinstalled under its own namespace rather than `custom`. |
336335
| **dependencies** | `Record<string, string>` | optional | The packages this package depends on, each id mapped to its version range, as its registry row's manifest declares them; absent when the row declares none. An install of the export orders it after each of them (ADR-0141 D5), and a `.custom` pair keeps the edge to its base that admits its overrides (ADR-0146 D2). |
337336
| **label** | `string` | optional | Display label, when the package declares one. |
338-
| **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. |
337+
| **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. |
339338

340339

341340
---
@@ -352,7 +351,7 @@ A field or flow another package contributes to one of the base's objects.
352351
| **namespace** | `string` | optional | The namespace the package was installed with, as its registry row's manifest declares it; absent when the row declares none. An install of the export keeps it instead of deriving one from the id, so a `.custom` pair is reinstalled under its own namespace rather than `custom`. |
353352
| **dependencies** | `Record<string, string>` | optional | The packages this package depends on, each id mapped to its version range, as its registry row's manifest declares them; absent when the row declares none. An install of the export orders it after each of them (ADR-0141 D5), and a `.custom` pair keeps the edge to its base that admits its overrides (ADR-0146 D2). |
354353
| **label** | `string` | optional | Display label, when the package declares one. |
355-
| **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. |
354+
| **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. |
356355

357356
### Nested Shape: `PackageExportManifest.withheldMaps[number]`
358357

0 commit comments

Comments
 (0)