Skip to content

Commit 79f4008

Browse files
committed
docs(simulations): clarify simulation filename handling post-push
Updated the documentation to specify that local simulation resource filenames are stable and not rewritten to match platform names after the first push. This change highlights that once a UUID is tracked, subsequent pulls and bootstraps preserve the existing filename and only update file content, addressing previous behavior that caused `name_mismatch` warnings. This clarification improves understanding of the filename management process in the context of the gitops engine.
1 parent 1febddc commit 79f4008

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

docs/learnings/simulations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ If your post-call analytics structured output uses `type: object` with nested sc
145145

146146
## Simulation File Names After Push
147147

148-
Simulation resource files use placeholder UUIDs (`a0000000`) locally. After the first push, the gitops engine creates platform resources and maps local filenames to platform UUIDs in `.vapi-state.<env>.json`. On subsequent state syncs (bootstrap), filenames may be updated to include the platform name — this triggers `name_mismatch` warnings that are resolved automatically by re-running bootstrap.
148+
Simulation resource files use placeholder UUIDs (`a0000000`) locally. After the first push, the gitops engine creates platform resources and maps local filenames to platform UUIDs in `.vapi-state.<env>.json`. The local filename is a stable handle and is **not** rewritten to match the platform `name`once a UUID is tracked in state, pull and bootstrap preserve the existing filename and only update file content. (Older engine versions renamed files to match the platform name and emitted `name_mismatch` warnings; that behavior was removed — see `improvements.md` #22.)
149149

150150
---
151151

0 commit comments

Comments
 (0)