fix(claude,server): keep Desktop applied-state markers honest across edits

[luvs01]

Summary

• Native launch fallback: strip CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST only when the admission credential is ours, so a user-owned gateway keeps its guard instead of losing it while the credential stays.
• Desktop profile rebuilds: carry appliedFingerprint/appliedAt only when the desired profile is unchanged, so a saved edit no longer reports the old on-disk config as applied. The management PUT discards client-supplied markers and restores the server-owned ones only for an identical result.
• ocx sync: persist the fingerprint of the exact Desktop config just written through the config-mutation lock, so the applied marker advances with the bytes instead of going stale.

Verification

• bun test tests/clients/desktop-profile.test.ts tests/clients/sync-client-integrations.test.ts tests/claude-integration/claude-cli.test.ts tests/claude-integration/claude-management-api.test.ts — all pass
• bun x tsc --noEmit — clean

Checklist

• Scope stays focused and avoids unrelated cleanup.
• Docs or release notes were updated when needed.
• Security-sensitive changes were reviewed for secrets, auth, and unsafe defaults.

Review readiness checklist

This PR stays in draft until every box below is ticked. Tick all four boxes once the requirements are met:

• All CI tests are green on my local testing.

• I pushed my PR to the latest dev commit.

• I resolved all correct Codex and CodeRabbit findings.

• My PR is ready for review.

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

✅ Deterministic PR hygiene checks passed.

[lidge-jun]

리뷰 · 우선순위 56 / 80

이 PR은 Claude Desktop의 “적용됨” 표시가 거짓말을 하던 구멍을 막는다. 예전에는 프로필을 다시 만들 때마다 appliedFingerprint/appliedAt을 무조건 이어 붙였다. 그래서 저장·드래그로 원하는 설정이 바뀌어도 화면은 예전 디스크 설정을 아직 적용된 것처럼 보여 줬다. 이제는 원하는 내용(assignments/defaults)이 같을 때만 표시를 남기고, 내용이 바뀌면 지운다. 관리 API PUT은 클라이언트가 보낸 표시를 버리고, 서버가 갖고 있던 표시만 “내용이 진짜로 같을 때” 다시 붙인다. ocx sync는 Desktop 파일을 쓴 직후, 그 바이트의 fingerprint를 설정 잠금(mutatePersistedConfig) 안에서 같이 저장해서 표시가 파일과 어긋나지 않게 한다. 네이티브 실행 쪽은 CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST를 무조건 지우지 않고, 우리가 넣은 admission 자격증명이 있을 때만 지운다. 사용자가 쓰는 게이트웨이·키가 남는데 호스트 관리 가드만 빠지던 경우를 막는다. 베이스는 dev다. 관련 테스트가 같이 바뀌었고, types.ts/config.ts 분할·중복 tip과는 무관하다.

라인 - sameProfileContent (src/claude/desktop-profile.ts): assignments는 키를 정렬해 비교하지만 defaults는 JSON.stringify만 한다. 가족 키 순서가 달라지면 내용은 같은데 “바뀜”으로 보고 표시를 지울 수 있다. 지금은 같은 코드 경로에서 키 순서가 거의 같아서 잘 안 터지지만, 비교 방식이 한쪽만 정렬돼 있다.
라인 - Claude Desktop PUT (src/server/management/agent-settings-routes.ts): 클라이언트가 아무 것도 안 바꾼 것처럼 보여도, reconcile이 카탈로그에 새로 생긴 모델을 assignments에 넣으면 current.profile과 달라져 적용 표시가 지워진다. 의도된 동작일 수 있지만, “저장만 했는데 미적용으로 바뀜”으로 보일 수 있다.
라인 - syncEnabledClientIntegrations (src/server/management/config-routes.ts): Desktop 파일 쓰기와 fingerprint 저장이 한 트랜잭션이 아니다. 쓰기는 됐는데 mutatePersistedConfig가 unavailable이면 sync는 실패로 보고하고, 디스크 Desktop은 새 내용·설정의 표시는 옛 값으로 남을 수 있다.
라인 - moveDesktopRoute: 가족이 바뀌면 표시를 그냥 버리고, preserveDesktopAppliedState는 안 탄다. 내용이 바뀌는 경로라 결과는 맞고, reconcile/setDefault와 스타일만 다르다.

메인테이너의 판단이 필요한 지점

카탈로그에 모델이 늘어서 reconcile만으로 assignments가 커질 때도 적용 표시를 지울지, “사용자가 고른 라우팅만” 바뀌었을 때만 지울지. 지금 코드는 전자다.

sync에서 Desktop 쓰기는 됐는데 표시 저장만 실패했을 때, 지금처럼 전체 실패로 둘지, 부분 성공(쓰기는 됨·표시만 실패)으로 나눌지.

너의 추천

방향은 맞고 테스트도 핵심을 덮는다. defaults 비교도 키를 정렬하거나 DESKTOP_FAMILIES 순으로 맞춰라. sync의 쓰기/표시 어긋남은 메인테이너가 위 판단만 정하면 된다. 그다음 dev에 머지해도 된다. 닫을 중복·무효 tip은 없다.

이 댓글은 grok-bot이 작성했습니다

[github-actions]

✅ READY

• all PR quality gates passed; the review readiness checklist is complete.

Review readiness checklist

• ✅ All CI tests are green on my local testing.
• ✅ I pushed my PR to the latest dev commit.
• ✅ I resolved all correct Codex and CodeRabbit findings.
• ✅ My PR is ready for review.

✅ 4/4 boxes ticked.

Automatic ready-for-review conversion failed; please mark the pull request ready manually if it is still a draft.
The review-ready label marks this PR as ready; review automation runs independently.
Maintainers notified: @lidge-jun @Ingwannu

[luvs01]

Consolidated into #5590 as a single related-function aggregate.

Source head: 3254286503f4c06a05c6aac2feadd9b4821977bb. Replacement head: 2f61b77dd54e07d67637224a3fc4ccf250ab4739.

The complete source contribution is carried as 4b90189 with matching zero-context stable patch ID d8d19e23f8d711b1c9812e674874cc45a36f5912. Final source review preserves profile-marker ownership, management PUT behavior, native gateway guard ownership and exact written-fingerprint persistence. The replacement additionally fixes concurrent desired-profile edits/deletions and the review concern about defaults key order. The final sync/profile suites passed 55 tests with 653 assertions on pinned Bun 1.4.0; type, structure, privacy and size checks passed. Full hosted CI, independent security review and the recorded Windows timing limits remain tracked on the draft replacement.

Closing this duplicate standalone review entry as part of the requested consolidation after verifying coverage. This is not a merge or release claim; remaining integration checks and reviews are tracked on the replacement. Original branches are retained.