문제: 전이를 적용한 핸들이 그 전이를 다시 보낼 때 세 저장소가 서로, 그리고
포트 Javadoc과 다르게 답한다(재리뷰 round8 RR8-04-01·02, 같은 원인).
- markFailed를 다른 disposition으로 다시 보내면 fake·Redis·PostgreSQL 모두
NOT_OWNER다. 기록을 남이 가져갔다는 틀린 신호이고 Javadoc은
OPERATION_CONFLICT라고 적는다.
- retention만 다르면 fake·Redis는 ALREADY_MARKED_SAME_OPERATION, PostgreSQL은
fail digest에 retention이 들어 있어 OPERATION_CONFLICT다.
- Redis는 start가 돌려준 핸들로 renew한 뒤 그 핸들로 start를 보내면
ALREADY_STARTED_SAME_OPERATION으로 답한다. renew도 기록을 EXECUTING·
revision+1로 두어 TRANSITION이 상태와 revision만으로는 start와 구별하지
못한다. executor는 그 답에 action을 실행해 이미 도는 작업을 한 번 더
돌린다. fake·PostgreSQL은 NOT_OWNER다.
원인은 하나다. "적용한 핸들"을 revision 하나로만 가리고 전이 종류와 인자를
같이 보지 않는다.
방법: 소유자 결정(2026-11-07, 1103 README 19.4절 ② (a))대로 다른
disposition은 OPERATION_CONFLICT, 다른 retention은 "이미 처리됨"으로 맞춘다.
retention은 complete의 replay TTL처럼 결과를 얼마나 보관하나일 뿐이라
비교하지 않는다.
- Redis: 기록 hash에 lastKind(CLAIM·START·RENEW·COMPLETE·FAIL)를 남긴다.
TRANSITION의 재전송 판정은 "rev == 핸들 rev + 1 그리고 lastKind == 이
전이"다. 그 안에서 상태가 목표면 ALREADY, 아니면(다른 disposition의
실패) OPERATION_CONFLICT. claim·takeover는 CLAIM을 써 넘겨받기 전 종류가
남지 않게 한다. 어댑터가 전이 종류를 9번째 인자로 보낸다. 명령 fake를
같이 고친다.
- PostgreSQL: fail 재생 판정이 두 실패 종류(FAIL_RETRYABLE·FAIL_ABANDONED)를
모두 실패의 재생으로 읽는다. fail digest에서 retention을 뺀다.
- fake: 적용한 핸들의 markFailed 재전송에 disposition이 다르면
OPERATION_CONFLICT.
- 공유 계약 IdempotencyStoreContract에 케이스 셋(다른 retention, 다른
disposition과 기록 유지, renew 뒤 같은 핸들의 start)을 더했다.
- PostgreSqlIdempotencyIntegrationTest의 "다른 retention은 conflict" 케이스가
옛 동작을 고정하고 있어 결정대로 "이미 처리됨, 처음 retention 유지"로
바꿨다(...IsConfirmedAndKeepsItsRetention).
IdempotencyFailOutcome·IdempotencyStartOutcome·IdempotencyStorePort Javadoc,
결정 색인 2.4절(새 행과 「넘겨받기 전 핸들의 재전송」 적용 조건),
application-core CLAUDE.md·README, cache-redis·persistence-jpa README,
TESTING_STRATEGY, 업그레이드 안내 5절 행을 같이 고쳤다.
버린 대안: 다른 disposition을 NOT_OWNER로 두고 Javadoc만 고치기(19.4절 ②
(b), 소유자가 고르지 않음, 적용한 핸들에 "넘겨받혔다"는 틀린 신호),
다른 retention도 OPERATION_CONFLICT(② (c), Redis 기록에 retention을 더하고
Lua를 바꿔야 하며 보관 기간을 인자로 본다), Redis start 분기만
"renewedFromRev가 있으면 ALREADY 아님"으로 막기(같은 상태에 머무는 전이가
늘면 다시 갈라진다).
위험·한계: 템플릿 호출자(IdempotencyExecutor)는 같은 인자로만 다시 보내고
renew를 부르지 않아 HTTP 동작은 같다. 포트를 직접 부르는 코드만 답이
바뀐다. 이 배포 전에 쓰인 Redis 기록에는 lastKind가 없어, 새 프로그램이
그 기록의 전이를 재전송으로 보지 않는다. 핸들은 프로세스 메모리에만 있고
같은 프로세스는 같은 프로그램을 돌리므로, 새 프로그램이 옛 프로그램이
적용한 전이의 핸들을 받는 경로는 템플릿에 없다고 본다(실행으로 확인하지
않음). PostgreSQL도 같은 이유로 옛 fail digest(retention 포함)와 새
digest를 같은 핸들로 비교하는 경로가 없다고 보고 digest VERSION을 올리지
않았다.
검증: desktop, 공유 잠금, --no-build-cache, 기준 3eb3b067.
- RED(기준 커밋 + 계약 케이스만, 로그 ~/r9-g4-red-logs/red-summary.txt):
fake 62 중 1 실패(다른 disposition "expected: OPERATION_CONFLICT but was:
NOT_OWNER"), Redis 명령 fake 62 중 2·실 Redis(redisContainerContractTest)
103 중 2 실패(다른 disposition, renew 뒤 start "expected: NOT_OWNER but
was: ALREADY_STARTED_SAME_OPERATION"), 실 PostgreSQL 62 중 2 실패(다른
disposition, 다른 retention "expected: ALREADY_MARKED_SAME_OPERATION but
was: OPERATION_CONFLICT").
- GREEN(이 커밋과 같은 트리 5a74698d, 로그 ~/r9-g4-green-logs/와 pass2/,
수는 결과 XML에서 셈 test-counts.txt): 네 leaf check(application-core 426·
skip 19 fake 시간 케이스, cache-redis 228, redis-runtime 65,
persistence-jpa 666)와 testQualityCheck, redisContainerContractTest 103,
jpaPlatformContractTest 432, fake를 쓰는 leaf(composition:idempotency 32,
redis-sdk 310, web 341, sample-portfolio 339), documentContractTest 67 —
모두 rc=0, 실패 0. postgresqlIdempotencyIntegrationTest는 1차에서 위 옛
케이스 1건이 실패했고, 고친 뒤 pass2에서 persistence-jpa spotlessCheck·
check·testQualityCheck와 함께 10 중 실패 0, rc=0.
- scripts/check-work-docs.py rc=0, git diff --check 통과.
BREAKING CHANGE: IdempotencyStorePort 구현은 적용한 핸들이 markFailed를 다른
disposition으로 다시 보내면 OPERATION_CONFLICT, retention만 다르면
ALREADY_MARKED_SAME_OPERATION으로 답해야 하고, renew를 적용한 핸들의 start를
"이미 시작됨"으로 확인하면 안 된다(NOT_OWNER). 직접 구현한 store는
IdempotencyStoreContract의 새 케이스로 확인한다.