Skip to content

feat(proxy): translate CloudFormation-generated physical names across restarts - #46

Merged
sanlega merged 1 commit into
mainfrom
feat/19-cfn-physical-names
Nov 13, 2026
Merged

sanlega merged 1 commit into
mainfrom
feat/19-cfn-physical-names

Conversation

@sanlega

@sanlega sanlega commented Nov 13, 2026

Copy link
Copy Markdown
Owner

Closes #19

Physical names that CloudFormation generates (stack-Q-C212895A2991 for a queue without QueueName) only appear in read responses, so they changed after every restart.

How

  • After a successful CreateStack / UpdateStack / ExecuteChangeSet, a background thread polls DescribeStackResources until nothing is *_IN_PROGRESS and journals that answer as its own row (so snapshot, compact and DeleteStack pairing treat it like any other row).
  • On replay, that row waits for the replayed stack to settle (non-2xx still gives up after the usual 30 s) and pairs old/new physical IDs by logical ID, not by position.
  • A snapshot whose polling crosses an emulator restart is dropped (boot generation counter): the replay of the deploy takes its own.

Limits (documented): a stack still deploying when keepstack stops keeps new names; only the query (form) protocol.

Tests

  • Unit: pairing by logical ID in any order, snapshot journaled once settled, replay waits and translates, snapshot dropped across a restart.
  • E2E tests/test_e2e_cfn.py: unnamed queue in a stack, kill keepstack + container, restart: DescribeStackResources returns the original URL and SendMessage/GetQueueAttributes on it work. Fails without the fix (names-Q-581B9682522D != names-Q-2126D0F6E1ED).
  • scripts/verify.ps1: 147 tests OK. README + es/zh-CN, compatibility, how-it-works, CHANGELOG updated.

🤖 Generated with Claude Code

@sanlega sanlega added type: feature New capability area: proxy Journal, replay, ID translation labels Nov 13, 2026
@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

keepstack validate: examples/quickstart ✅ passed

Step Result
init ✅ ok
plan ✅ ok
apply ✅ ok
idempotency ✅ ok
smoke ✅ ok

Plan: 0 to add, 0 to change, 0 to replace, 0 to destroy

keepstack · 15.3 s · AWS Emulator, no AWS account used

… restarts (#19)

After CreateStack, UpdateStack or ExecuteChangeSet, keepstack polls
DescribeStackResources until the stack settles and journals the answer.
The replay waits for the replayed stack and pairs old and new physical
names by logical ID.
@sanlega
sanlega force-pushed the feat/19-cfn-physical-names branch from b6ef49f to 774c38f Compare November 13, 2026 23:08
@sanlega
sanlega merged commit f46dc38 into main Nov 13, 2026
12 checks passed
@sanlega
sanlega deleted the feat/19-cfn-physical-names branch November 13, 2026 23:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: proxy Journal, replay, ID translation type: feature New capability

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Translate CloudFormation-generated physical names across restarts

1 participant