fix: 요소 안정 ID 도입 리뷰 확정 결함 수정

[lee-sihun]

#123 리뷰에서 확정된 결함들을 고칩니다. feature/stable-element-id에서 분기했고 base도 그 브랜치입니다 — #123을 머지하기 전에 이 PR을 먼저 머지하면 됩니다.

배경

#123의 코드 리뷰에서 후보 55건을 수집해 32건을 적대적으로 검증했고, 24건이 확정됐습니다. 이 PR은 그중 실사용에 영향이 있는 HIGH 5건 + MEDIUM 4건을 고칩니다. 각 수정에는 회귀 테스트를 붙였고, 여러 건은 수정을 되돌려 테스트가 실제로 실패하는지 확인했습니다.

백엔드 (Rust)

v1 플러그인 호환 계약 복원 — pluginWriteGateway가 약속한 "id 없는 레거시 입력 장기 수용"이 실제로는 깨져 있었습니다.

• id 없는 위치 단독 패치가 전부 거부되던 문제: 값이 바뀐 요소마다 새 UUID가 발급돼 id 순서가 흔들리고, 새로 추가된 paired 검사가 통상적인 플러그인 위치 업데이트를 PAIRED_UPDATE_REQUIRED(비재시도)로 막았습니다. keys를 동반하지 않는 패치는 validate_paired_update가 형태 불변을 보장하므로, 그 경로에 한해 index를 신원으로 삼아 제자리 id를 먼저 확정합니다.
• 슬롯 불변인데 값만 바뀌면 ID가 재발급되던 문제: 슬롯 승계 웨이브가 모두 값 일치를 요구했습니다. 값을 무시하고 같은 모드·같은 index의 슬롯 일치만 보는 웨이브를 추가하고, 우연한 값 일치보다 앞에 둡니다.
• 읽은 객체를 복사해 요소를 복제하면 하드 거부되던 문제: id가 플러그인 읽기에 노출되면서 관용적인 복사-덧붙이기 패턴이 DUPLICATE_ELEMENT_ID를 받았습니다. v1에서는 소유가 어긋나거나 중복된 id를 거부 대신 비워 승계·신규 발급 경로로 넘깁니다(형식 오류는 호출부 버그 신호이므로 거부 유지). 타 컬렉션 id 이식도 함께 막힙니다.
• ID가 모드 간에 무음으로 이동하던 문제: 값 매칭이 전 모드를 사전순으로 훑었습니다. 같은 모드 우선으로 정렬합니다.

store 오염 경로 차단 — stat/graph/knob_positions_update 레거시 커맨드가 id를 전혀 검증하지 않아 빈 id가 canonical store에 들어갈 수 있었고, 그 뒤로는 네이티브 컬렉션을 건드리는 모든 편집이 MISSING_ELEMENT_ID로 거부됐습니다(오염 컬렉션과 무관한 편집까지). 레거시 트랜잭션 경계에서 선언된 컬렉션에 한해 백필합니다.

프리셋 관용 복원 — 프리셋 로드가 검증 직전 전 요소를 rekey해서 한도 초과·라벨 길이·그림자 등 그랜드파더링 조회가 전부 실패했고, 관용 상태를 가진 사용자는 자기 프리셋 백업을 다시 불러올 수 없었습니다. 관용 신원 기준을 GrandfatherKeying으로 명시해 프리셋 트랜잭션에서만 자리 기준으로 판정합니다(일반 편집 경로는 ID 기준 유지 — 새 요소가 남의 관용을 물려받지 않습니다). 탭 프리셋이 key_positions만 무조건 rekey하던 것도 기록 여부로 게이트하고, 미기록 컬렉션은 빈 항목만 백필합니다.

프론트엔드

• 붙여넣기 중 Delete가 원본을 지우던 문제: 선택 갱신이 커밋 라운드트립 뒤로 밀려 사본이 보이는데도 선택은 원본을 가리켰습니다. eager 적용 직후 동기 구간으로 되돌립니다.
• 분리 패널에서 레이어 드롭이 오동작하던 문제: 새 buildLiveLayerModel이 창 인지 selector 대신 raw store를 읽어, 분리 패널에서는 플러그인 행이 드롭 기준 모델에서 통째로 빠졌습니다(플러그인 행 드래그는 무음 no-op, 네이티브 드롭은 z 재부여 오류). 결정론적으로 재현되던 회귀입니다.
• 백엔드 ID 재발급 시 선택이 사라지던 문제: id 조회 실패 시 즉시 제거했습니다. 그 자리 요소가 id만 빼고 동일하면 새 id로 재채택하고, 내용이 다르면 기존처럼 선택을 풉니다.
• 붙여넣기가 복사본의 상하 순서를 뒤집던 문제: 블록이 타입별 payload 순서로 조립되는데 배열 위치가 곧 최종 z였습니다. 원본 z 내림차순으로 정렬합니다.
• 드롭이 엉뚱한 그룹에 편입되던 문제: 아이템 드롭이 index만 live 모델로 재해석하고 그룹은 캡처값을 그대로 썼습니다. 재유도하되, 접힌 그룹 헤더 드롭은 그룹 편입이 명시적 의도이므로 제외합니다.
• 레이어 드롭이 반쪽만 저장되던 문제: 영속되는 플러그인 z 쓰기가 fail-closed 게이트보다 먼저 실행됐습니다. 게이트 뒤로 옮기고, 러너가 실제로 receipt를 되돌린 경우에만 CAS로 복원합니다(편입 후 transient 실패는 재시도가 소유하므로 건드리지 않습니다).

검증

cargo test 497건, cargo clippy 경고 0, cargo fmt 클린, tsc --noEmit 0건, vitest 1222건, lint 신규 경고 0건. 플러그인 API 문서는 변경된 id 의미론에 맞춰 en/ko 양쪽을 갱신했습니다.

이번 PR에서 제외한 것

혼합 선택의 "맨 앞으로/맨 뒤로" 순서(MEDIUM): 네이티브와 플러그인을 함께 선택해 z를 옮기면 선택 순서와 무관하게 네이티브가 항상 플러그인 위에 놓입니다. 최소 수정은 기존의 결정론을 없애면서 선택 순서 보장도 주지 못해 어느 쪽도 아닌 상태가 됩니다. 제대로 고치려면 applyZOrderByIds에 명시적 순서 인자를 추가하고 플러그인·네이티브를 같은 z 밴드로 묶어야 하는데, 공유 런타임과 호출부 8곳에 영향이 가므로 별도 PR이 적절합니다.

리뷰에서 함께 나온 저심각도 항목(중복 id keeper 선정 규칙의 문서 정밀도, buildLayerItems의 tabId 필터 부재 등 기존 결함)도 후속으로 남깁니다.

🤖 Generated with Claude Code

[eun-yeon]

살려줘

[lee-sihun]

할 수 있어