Skip to content

Commit 3980d79

Browse files
committed
chore(spec): regenerate the package-lifecycle reference for the planned withheldMaps describe
Claude-Session: https://claude.ai/code/session_01ADHkmPi3pqv7Vkx4kymD87 Co-authored-by: Claude <noreply@anthropic.com>
1 parent cbce5d3 commit 3980d79

1 file changed

Lines changed: 8 additions & 1 deletion

File tree

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

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,13 @@ 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
48+
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.
52+
4653
<Callout type="info">
4754
**Source:** `packages/spec/src/api/package-lifecycle.zod.ts`
4855
</Callout>
@@ -318,7 +325,7 @@ A field or flow another package contributes to one of the base's objects.
318325
| **name** | `string` | ✅ | The exported package's machine name. |
319326
| **version** | `string` | ✅ | The exported package's version. |
320327
| **label** | `string` | optional | Display label, when the package declares one. |
321-
| **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. Absent when the export withheld nothing. |
328+
| **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. |
322329

323330
### Nested Shape: `PackageExportManifest.withheldMaps[number]`
324331

0 commit comments

Comments
 (0)