Skip to content

Commit 540c15d

Browse files
author
Looper
committed
docs(tools-pack): clarify cache materialization exceptions
Generated-By: looper 0.11.2 (runner=fixer, agent=codex)
1 parent 1605820 commit 540c15d

1 file changed

Lines changed: 11 additions & 4 deletions

File tree

tools/pack/CACHE.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -109,9 +109,13 @@ Current materialization-time parameters:
109109
`posthogKey`/`posthogHost`, `webOutputMode`, and `namespaceBaseRoot` — is
110110
regenerated on the materialization path by `writePackagedConfig`.
111111

112-
Downstream archive nodes (`win.nsis-*`, `win.portable-zip`,
113-
`win.launcher-payload*`) carry `namespace` and the full `packagedVersion` in
112+
Downstream archive nodes (`win.nsis-*`, `win.portable-zip`, and
113+
`win.launcher-payload`) carry `namespace` and the full `packagedVersion` in
114114
their keys, because their content is the already-stamped payload.
115+
`win.launcher-payload-base` is the exception: its key carries `namespace`, but
116+
version identity reaches it only indirectly through the upstream `sourceKey`;
117+
the final `win.launcher-payload` archive explicitly carries the
118+
version-bearing `manifest` and `configBody`.
115119

116120
**Requirement.** A value may be a materialization-time parameter only when
117121
both hold:
@@ -122,8 +126,11 @@ both hold:
122126

123127
Adding a materialization-time parameter without (2) is not permitted.
124128

125-
> Known asymmetry: app version satisfies (2); namespace currently satisfies
126-
> only (1) — it is rewritten but not asserted.
129+
> Known asymmetry: app version satisfies (2). The other regenerated config
130+
> fields — `namespace`, `amrProfile`, `telemetryRelayUrl`,
131+
> `updateMetadataUrl`, `posthogKey`, `posthogHost`, `webOutputMode`,
132+
> `namespaceBaseRoot`, and the packaged entrypoint fields — currently satisfy
133+
> only (1): they are rewritten but not asserted.
127134
128135
## Signing boundary
129136

0 commit comments

Comments
 (0)