# Meshery v1.0.80

2026-11-16 · [릴리스 노트 원문](https://github.com/meshery/meshery/releases/tag/v1.0.80) · [전체 정리](https://ratatosk.io/ko/releases/meshery/v1.0.80)

보안 22 · 호환성 변경 34 · 중요 수정 84 · 기능·개선 6 · 기타 71

## 보안 (22)

### Kubernetes 컨텍스트 자격 증명, `GetContext` 응답에서 마스킹

- 영향 대상: `GetContext` 엔드포인트(`GET /api/system/kubernetes/contexts/{id}`)를 사용하는 설정

이 변경 전에는 엔드포인트가 인증 정보와 클러스터 값을 HTTP를 통해 평문으로 노출했습니다. 여기에는 개인 키, 인증서, 베어러 토큰이 포함됐습니다. 이제 응답에서 이러한 자격 증명을 제외하고 컨텍스트 식별자와 공개 엔드포인트 메타데이터는 유지합니다.

> - [Server] Redact sensitive auth credentials in GetContext HTTP response @Supersaiyan101 (#23797)

### 자격 증명 삭제 시 소유권 확인 적용

- 영향 대상: `DefaultLocalProvider`를 통한 자격 증명 삭제
- 추가 조치: 유효한 인증을 받은 사용자

이전에는 자격 증명 ID만 확인해 삭제 대상을 찾았기 때문에, 소유권을 확인하지 않고도 다른 사용자의 자격 증명을 삭제할 수 있었습니다. 이제 다른 사용자의 자격 증명을 삭제하려는 요청이나 유효한 신원이 없는 요청은 찾을 수 없음 응답을 반환하고 자격 증명을 그대로 둡니다.

> - [Server] Enforce user ownership validation in credential get and delete @Supersaiyan101 (#23661)

### Meshery SSE 스트림 타임아웃 수정

- 영향 대상: Meshery 부하 테스트 SSE 스트림, `/api/providers/stream`, `/api/system/adapter/events`

2분 이상 실행되는 부하 테스트에서 마지막 결과 프레임이 유실될 수 있었고, providers 및 adapter-events 스트림은 2분마다 끊겼습니다. 이제 이 스트림은 2분이 지나도 계속되며, 프레임마다 30초의 쓰기 데드라인이 새로 적용됩니다.

> - [Server] Stop the HTTP server timeouts from cutting off SSE streams and slow uploads @SandstromPL (#23634)

### 토큰 파일 권한 강화

- 영향 대상: Windows의 `mesheryctl` 토큰 파일과 Windows 외 플랫폼에서 생성되는 토큰 파일

Windows에서는 기존 토큰 파일의 접근 권한이 더 넓은 경우 현재 사용자로 제한하고, 업데이트할 때는 비공개 임시 파일을 사용합니다. 접근 제한을 확인할 수 없거나 업데이트에 실패하면 오류를 보고하고 기존 토큰은 변경하지 않습니다. Windows 외 플랫폼에서 새로 만든 토큰 파일에는 `0600` 모드를 사용합니다.

> - fix: restrict Windows token file permissions @0xmaster7 (#23380)

### `mesheryctl design export`의 안전하지 않은 내보내기 경로 수정

- 영향 대상: `mesheryctl design export`로 내보낸 디자인

이름에 `/`, `\`, 또는 `../`가 포함되면 하위 디렉터리가 만들어지거나 내보낸 파일이 `--output` 바깥에 기록될 수 있었습니다. 이제 안전하지 않은 문자는 `_`로 바뀌어 파일이 `--output` 바로 아래에 저장됩니다. `my-design`처럼 이미 안전한 이름은 이전과 같은 파일명을 유지합니다.

> - [mesheryctl] sanitize the design name in design export file paths @rakesh0x (#23557)

### mesheryctl의 정의되지 않은 토큰 할당 거부

- 영향 대상: `mesheryctl system token set`에서 `tokens:`에 없는 이름을 사용하는 할당

이전에는 `system token set <name>` 명령이 일치하는 `tokens:` 항목이 없는 이름도 저장해, 이후 요청에서 해당 컨텍스트의 서버로 기본 토큰을 보낼 수 있었습니다. 이제 이 명령은 오류를 반환하고 컨텍스트를 변경하지 않습니다.

> - [mesheryctl] Reject unknown tokens in token set and in-use tokens in token delete @Asheesh7298 (#23457)
> - [mesheryctl] Reject unknown tokens in token set and in-use tokens in token delete @Asheesh7298 (#23457)

### Windows 토큰 파일의 현재 사용자 접근 제한

- 영향 대상: Windows `mesheryctl` 토큰 파일

이전에는 `Chmod(0600)`이 기존 ACL이나 상속된 ACL을 제거하지 않아 공유 디렉터리의 토큰 파일을 다른 사용자도 읽을 수 있었습니다. 이제 `WriteTokenFile`을 통한 쓰기와 다시 쓰기에서 현재 사용자의 SID에 대한 보호 ACL을 적용합니다. 제한에 실패하면 기존 토큰을 그대로 유지하며, Unix 동작은 변경되지 않았습니다.

> - [mesheryctl] Enforce owner-only token file on Windows via explicit DACL @Pastoray (#23507)
> - [mesheryctl] Enforce owner-only token file on Windows via explicit DACL @Pastoray (#23507)

### 성능 프로파일 엔드포인트의 nil 프로바이더 및 로거 패닉 수정

- 영향 대상: 성능 프로파일 엔드포인트

프로바이더가 없거나 typed-nil이거나 핸들러 로거를 사용할 수 없는 경우, 엔드포인트가 요청을 처리하다 서버 패닉이 발생할 수 있었습니다. 이제 프로바이더가 없으면 `ErrNilProviderCode` 500 응답을 반환하며, 보호된 로거 호출은 더 이상 패닉을 일으키지 않습니다.

> - [Server] Guard nil provider and nil logger in performance profile handlers @antcybersec (#23772)

### Docker Extension 프록시 인증 토큰 로그 노출 수정

- 영향 대상: Docker Extension 프록시 요청 및 백엔드 오류 로그 (추정)

요청 로그와 백엔드 오류 로그에 인증 토큰이 노출되었습니다. 이제 쿼리 매개변수 형식이 잘못된 경우에도 해당 로그에서 토큰을 마스킹합니다. 삭제 경로에서는 빈 토큰이나 채널도 더 이상 로그에 남기지 않습니다.

> - [Docker Extension] Don't hang token store and logout when no websocket client is connected @CyberRik (#23765)

### MeshSync 엔드포인트의 nil 포인터 패닉 수정

- 영향 대상: MeshSync의 네 엔드포인트

이 핸들러에서는 nil이거나 초기화되지 않은 프로바이더 또는 퍼시스터, 그리고 사용할 수 없는 로거 경로로 인해 nil 포인터 패닉이 발생할 수 있었습니다. 이제 프로바이더나 퍼시스터가 없으면 500 `ErrNilProviderCode` 응답을 반환하고, nil 로거 경로에서는 더 이상 패닉이 발생하지 않습니다. 잘못된 입력이나 누락된 쿼리 매개변수에는 계속 검증 오류가 반환됩니다.

> - [Server] Guard nil provider, persister, and logger across MeshSync handlers @antcybersec (#23770)

### 스케줄 및 조직 핸들러의 nil 프로바이더와 로거 패닉 수정

- 영향 대상: 스케줄 엔드포인트 및 `GetOrganizations`

이 핸들러는 nil 프로바이더를 처리하거나 초기화되지 않은 로거를 호출할 때 패닉이 발생할 수 있었습니다. 여기에는 typed nil 프로바이더도 포함됩니다. 이제 해당 경로에서 패닉이 발생하지 않으며, 잘못된 스케줄 요청과 누락된 스케줄 ID에는 계속 적절한 오류 응답이 반환됩니다.

> - [Server] Guard nil provider and nil logger in schedule and organization handlers @antcybersec (#23768)

### `EvaluateRelationshipPolicy` nil 역참조 패닉 수정

- 영향 대상: 관계 정책 평가

사용자 또는 provider가 없거나, `h.SystemID`가 nil이거나, `h.evalTracker`가 초기화되지 않은 경우 핸들러에서 nil 역참조로 패닉이 발생할 수 있었습니다. 이제 사용자가 없으면 HTTP 401을 반환하고, provider가 없으면 HTTP 500을 반환합니다. 시스템 ID가 nil이면 `uuid.Nil`을 폴백으로 사용하고, 초기화되지 않은 평가 트래커는 초기화합니다.

> - [Server] Guard unchecked nil dereferences, unbounded body reads, and detached goroutine panics in EvaluateRelationshipPolicy @Amansingh0807 (#23664)

### `EvaluateRelationshipPolicy` 요청 본문 크기 제한 적용

- 영향 대상: `EvaluateRelationshipPolicy` 요청

이전에는 4 MB를 초과하는 본문도 크기 제한 없이 읽어 메모리 고갈 위험이 있었고, 빈 본문은 JSON 디코딩 전에 별도로 거부하지 않았습니다. 이제 크기 초과 본문에는 HTTP 413을, 빈 본문에는 HTTP 400을 반환합니다.

> - [Server] Guard unchecked nil dereferences, unbounded body reads, and detached goroutine panics in EvaluateRelationshipPolicy @Amansingh0807 (#23664)

### 자격 증명 GET 소유권 검증 추가

- 영향 대상: DefaultLocalProvider를 통한 자격 증명 GET 요청

이전에는 `GetUserCredentialByID`가 `credential.UserId`와 인증된 호출자의 `user.ID`가 일치하는지 확인하지 않고 자격 증명을 반환해 다른 사용자의 자격 증명이 노출될 수 있었습니다. 이제 다른 사용자의 자격 증명이나 소유자가 없는 자격 증명을 요청하거나, 호출자 신원이 확인되지 않은 요청에는 404를 반환합니다.

> - [Server] Enforce user ownership validation in credential get and delete @Supersaiyan101 (#23661)

### [보안 여부 불분명] nil `provider` 패닉 수정

- 영향 대상: `GetUsersKeys`가 처리하는 요청

프로바이더 초기화에 문제가 생기거나 부팅 중 요청이 핸들러에 도달하면, 이전에는 nil `provider` 때문에 nil 포인터 패닉이 발생해 서버가 중단될 수 있었습니다. 이제 이런 요청에는 프로세스를 중단하는 대신 `ErrNilProvider()`와 함께 HTTP 500이 반환됩니다.

> - fix(server): guard nil provider and validate org ID in GetUsersKeys @hemv-857 (#23645)

### ValidationHandler의 대용량 요청 처리 크래시 수정

- 영향 대상: `/api/registry/validate` 및 `/api/meshmodels/validate` 엔드포인트

이전에는 대용량 요청을 제한 없이 읽을 수 있어 OOMKilled 크래시가 발생할 수 있었습니다. 이제 4 MB를 초과하는 요청에는 제한 없이 읽는 대신 HTTP 413을 반환합니다.

> - [Server] Bound request body size and guard against DoS in ValidationHandler @Supersaiyan101 (#23589)

### `ValidationHandler`의 잘못된 요청에 대한 HTTP 400 응답

- 영향 대상: `/api/registry/validate` 및 `/api/meshmodels/validate` 엔드포인트

클라이언트 읽기 오류는 이전에 HTTP 500을 반환했습니다. 검증 전에 표준 JSON 공백을 제거합니다.

> - [Server] Bound request body size and guard against DoS in ValidationHandler @Supersaiyan101 (#23589)

### `DeleteConnection` UUID 검증 및 nil 참조 처리

- 영향 대상: `DeleteConnection` 엔드포인트

이전에는 형식이 잘못되었거나 nil인 연결 UUID에 경계 검증이 없었고, 사용자, 프로바이더 또는 시스템 정보가 없으면 역참조 패닉이 발생할 수 있었습니다. 이제 형식이 잘못되었거나 nil인 UUID는 HTTP 400을 반환합니다. 프로바이더가 nil인 요청은 HTTP 500을 반환하며, 사용자 또는 시스템 정보가 없어도 해당 역참조 패닉은 더 이상 발생하지 않습니다.

> - [Server] Validate connection ID and guard nil dereference in DeleteConnection @Supersaiyan101 (#23404)

### nil 프로바이더 처리 수정

- 영향 대상: 확장 설치·제거 핸들러 및 capability 영속성 처리

프로바이더가 없는 상태로 서버가 부분적으로 부트스트랩되는 동안 인증되지 않은 요청이 설치 또는 제거 핸들러에 도달하면, 검사하지 않은 역참조로 인해 패닉이 발생해 서버가 종료될 수 있었습니다. 이제 해당 상황에서 핸들러는 HTTP 500을 반환하며, capability 영속성 처리에서는 프로바이더가 nil인 경우 호출을 안전하게 건너뜁니다.

> - [Server] Guard nil provider dereference and unbounded body reads in extension install and remove handlers @Amansingh0807 (#23395)

### 익스텐션 핸들러의 대용량 본문 거부 및 nil provider 패닉 방지

- 영향 대상: 익스텐션 설치 및 제거

이전에는 provider가 초기화되지 않은 상태에서 두 핸들러 중 하나에 도달하면, 인증 없이 접근하거나 서버 부트스트랩이 일부만 진행된 경우에도 처리되지 않은 패닉이 발생해 서버가 종료됐습니다. 요청 본문도 크기 제한 없이 읽었습니다. 이제 4MB를 초과하는 본문에는 HTTP 413을 반환하고 요청 본문을 닫습니다.

> - [Server] Guard nil provider dereference and unbounded body reads in extension install and remove handlers @Amansingh0807 (#23395)

### Windows에서 긴 경로에 토큰 파일을 기록하는 mesheryctl 지원

- 영향 대상: 긴 경로에 토큰 파일을 기록하는 Windows 환경

> - fix: restrict Windows token file permissions @0xmaster7 (#23380)

### [보안 여부 불분명] MeshSync의 감시 리소스 접근 복구

- 영향 대상: MeshSync가 오퍼레이터 모드로 실행되는 Meshery Operator Helm 차트 설치
- 추가 조치: `meshsync.serviceAccount.dedicated` 활성화

이전에는 MeshSync가 감시 대상 리소스에서 `forbidden` 오류를 받아 디스커버리가 중단됐습니다. 이제 MeshSync에 읽기 권한이 부여되며, CRD에는 범위 제한 없는 list/watch 접근 권한도 부여됩니다. 기본 공유 ServiceAccount를 사용하면 오퍼레이터의 쓰기 권한도 계속 보유합니다.

> - [Helm] Give MeshSync read-only RBAC, expose Broker service values, clean up CRs on uninstall @yi-nuo426 (#23259)

## 호환성 변경 (34)

### 복제된 필터에 새 메타데이터 적용

- 영향 대상: Local provider를 사용하는 필터 복제 (추정)

Local provider가 필터를 복제할 때, 복제본은 이전에 원본의 `created_at`과 `catalog_data`를 그대로 물려받았습니다. 이제 복제본에는 자체 생성 시간이 설정되고 카탈로그 데이터는 포함되지 않지만, 원본의 파일, 리소스, 위치는 유지됩니다.

근거: “The copy +// keeps the source's file, resource and location, but gets its own creation +// time and no catalog data.” https://github.com/meshery/meshery/pull/23451

> - [Server] Clone designs and filters as fresh records @Asheesh7298 (#23451)

### 패턴 리소스 조회에서 삭제된 레코드 제외 및 누락된 레코드를 찾을 수 없음으로 보고

- 영향 대상: ID 또는 속성으로 수행하는 패턴 리소스 조회

이전에는 ID 및 속성 조회에서 누락된 레코드가 찾을 수 없음으로 매핑되지 않았고, ID 조회 결과에 소프트 삭제된 레코드가 포함될 수 있었습니다. 이제 그 밖의 데이터베이스 오류는 읽기 오류로 보고됩니다.

근거: “Pattern resource lookups now exclude deleted records and distinguish missing records from database errors.” https://github.com/meshery/meshery/pull/23667

> - [Server] Harden pattern resource persistence @0xmaster7 (#23667)

### 패턴 리소스 삭제 시 존재하지 않거나 이미 소프트 삭제된 리소스에 not-found 반환

- 영향 대상: 패턴 리소스 삭제

삭제 요청이 존재하지 않거나 이미 소프트 삭제된 ID를 대상으로 하고, 업데이트 결과 영향을 받은 행이 없을 때 발생합니다.

근거: “Deleting a resource that is missing or already deleted now returns a not-found error.” https://github.com/meshery/meshery/pull/23667

> - [Server] Harden pattern resource persistence @0xmaster7 (#23667)

### 스냅샷 로드 오류 시 Kubernetes 컨텍스트 삭제 중단

- 영향 대상: Kubernetes 컨텍스트 삭제

이전에는 Kubernetes 컨텍스트 목록 스냅샷을 불러오지 못해도 핸들러가 HTTP 200을 반환하고 삭제 전환을 시작했습니다. 이제는 삭제를 시작하기 전에 HTTP 500을 반환하므로 호출자가 재시도할 수 있습니다.

근거: “A failed Kubernetes context snapshot previously logged an error but returned 200 and started the delete transition without a usable list. The handler now reports the snapshot error before starting deletion, allowing the caller to retry.” https://github.com/meshery/meshery/pull/23613

> - [Server] Report context snapshot failures before deletion @0xmaster7 (#23613)

### 컨텍스트 삭제 시 명시적 HTTP 응답 반환

- 영향 대상: `DELETE /api/system/kubernetes/contexts/{id}`를 통한 컨텍스트 삭제

이전에는 삭제에 성공해도 상태 코드나 본문을 반환하지 않았습니다. 머신 초기화에 실패하면 핸들러가 오류 이벤트를 로그에 남기고 저장했지만, 응답은 보내지 않았습니다. 이제 성공 시 HTTP 200을 반환하고, 초기화 실패 시 `ErrFailToDelete`와 함께 HTTP 500을 반환합니다.

> - [Server] Write HTTP status 200 and error response in DeleteContext @nishant-devv (#23563)

### `SavePerformanceProfileHandler`의 요청 본문 크기 제한 및 검증

- 영향 대상: 성능 프로파일 저장 요청

4 MB를 초과하는 본문은 이전에는 오류 응답 없이 잘렸지만, 이제 HTTP 413 응답을 받습니다. 비어 있거나 공백만 있거나 `null`인 페이로드에는 HTTP 400 응답을 반환합니다.

근거: “Enforced defensive checks against empty, whitespace-only, and `"null"` payloads with `ErrRequestBody` (`HTTP 400 Bad Request`).” https://github.com/meshery/meshery/pull/23561

> - [Server] Guard invalid UUID status codes, missing 404 responses, and unchecked token extraction in performance profile handlers @Amansingh0807 (#23561)

### 존재하지 않는 성능 프로필 삭제 요청에 HTTP 404 반환

- 영향 대상: 성능 프로필 삭제
- 필요 조치: 오류 코드 재생성 또는 스키마 변경 불필요

로컬에 저장된 적 없는 ID를 삭제하면 이전에는 스텁 프로필과 함께 HTTP 200을 반환할 수 있어, 삭제에 성공한 것처럼 잘못 표시됐습니다. 이제 프로바이더가 프로필을 찾을 수 없다고 보고한 경우에도 HTTP 404를 반환합니다.

> - [Server] Return 404 when deleting a performance profile that does not exist @Shikhyy (#23544)

### Preference persister 입력 검증 및 없는 항목 삭제 처리

- 영향 대상: `SessionPreferencePersister`를 통한 preference 쓰기 및 삭제 (추정)

이전 릴리스에서는 데이터베이스 핸들러가 초기화되지 않았거나 `userID`가 비어 있거나 preference 데이터가 `nil`이면 쓰기 작업에서 패닉이 발생할 수 있었습니다. 존재하지 않는 preference를 삭제하면 `nil`을 조용히 반환해 HTTP 200으로 성공한 것처럼 보일 수도 있었습니다. 이제 데이터베이스 쿼리 전에 쓰기 입력을 검증하며, 존재하지 않는 preference를 삭제하면 `ErrResultNotFound`를 반환합니다.

근거: “`DeleteFromPersister` now verifies `res.RowsAffected == 0` and returns `ErrResultNotFound` when the target preference does not exist instead of returning silent `nil` (200 OK).” https://github.com/meshery/meshery/pull/23536

> - [Server] Guard nil database handler, validate userID, and check rows affected in preference persister @piyxsh31 (#23536)

### 존재하지 않는 환경에 대한 HTTP 404 처리

- 영향 대상: 환경 레코드

이전에는 존재하지 않는 환경 ID를 업데이트하면 행이 조용히 생성될 수 있었고, 존재하지 않는 ID에 대한 조회, 업데이트, 삭제 요청은 500 또는 502를 반환할 수 있었습니다. 이제 이러한 요청은 404를 반환하며, 업데이트를 해도 환경은 생성되지 않습니다.

> - [Server] Honour Environment purpose property and align SystemDatabaseModels to v1beta3 @SachinyadavAug20 (#23429)

### 활성 자격 증명이 일치하지 않을 때 업데이트 및 삭제 요청에 404 응답

- 영향 대상: 자격 증명 업데이트 및 삭제 요청

이전에는 이미 삭제된 자격 증명을 업데이트해도 변경 없이 200 응답을 반환할 수 있었고, 삭제를 반복하면 200 응답과 함께 `deleted_at` 값이 바뀌었습니다. 알 수 없는 ID에는 500 응답이 반환될 수 있었습니다. 이제 삭제를 반복해도 최초 삭제 기록이 그대로 유지됩니다.

근거: “On the local provider, `UpdateUserCredential` filtered its update on `deleted_at is NULL` but read the row back without it, so updating a deleted credential matched nothing and still returned the deleted row. The handler answered 200 and nothing changed. `DeleteUserCredential` matched by id only, so a second delete also answered 200 and moved `deleted_at`. An id that never existed came back as a bare `record not found`, which the handlers turned into a 500.” https://github.com/meshery/meshery/pull/23503

> - [Server] Return 404 when updating or deleting a missing credential @cortex36a (#23503)

### 연결 작업의 잘못된 ID 거부와 누락 데이터 처리

- 영향 대상: `POST /api/integrations/connections/{connectionId}/actions`

이전에는 형식이 잘못되었거나 빈 ID를 `uuid.FromStringOrNil`로 변환했고, MeshSync 작업 중 provider, user 또는 system 데이터가 없으면 패닉이 발생할 수 있었습니다. 이제 형식이 잘못되었거나 nil인 ID에는 HTTP 400을 반환하고, provider를 사용할 수 없으면 HTTP 500을 반환합니다. user 또는 system 데이터가 없어도 nil 역참조 패닉 없이 작업을 계속합니다.

근거: “Guards `provider == nil` before executing `setMeshsyncDeploymentModeAction` or `flushMeshsyncAction`, returning HTTP 500 with `"provider not initialized"` rather than panicking” https://github.com/meshery/meshery/pull/23417

> - [Server] Validate connection ID and guard nil dereferences in PerformConnectionAction @piyxsh31 (#23417)

### `mesheryctl perf result`의 설정된 명령 출력 writer 사용

- 영향 대상: 명령 출력 writer를 설정한 `mesheryctl perf result` 구성 (추정)

이전에는 확장된 결과와 포매터가 설정된 명령 출력 writer가 다르더라도 raw stdout에 출력했습니다. 변경 후에는 해당 출력이 설정된 writer로 전달됩니다.

근거: “Routed expanded result outputs and the output formatter to `cmd.OutOrStdout()` instead of raw `fmt.Printf` / `os.Stdout`.” https://github.com/meshery/meshery/pull/23729

> - [mesheryctl] Guard nil TestStartTime, fix dead check, and standardize timestamp in perf result (#23727) @muskan-creates352 (#23729)

### 원격 디자인 가져오기에서 URL 경로의 기본 파일명 사용

- 영향 대상: 명시적인 `--name`을 지정하지 않은 원격 디자인 가져오기
- 필요 조치: 경로에 파일명이 없는 원격 URL에는 명시적인 `--name` 지정 필요

이름을 만들 때 쿼리 문자열과 프래그먼트는 제외하지만, 요청에는 전체 URL을 전송합니다.

근거: “Derive the default name for remote imports from the URL path, excluding query and fragment while keeping the URL intact for the request.” https://github.com/meshery/meshery/pull/23703

> - [mesheryctl] Exclude URL query from imported design name @0xmaster7 (#23703)

### 로그용 Pod 선택 시 정확한 이름과 정제된 이름 우선

- 영향 대상: 지정한 Pod 이름으로 `mesheryctl`에서 로그 대상 Pod를 선택하는 경우

이전에는 여러 Pod와 일치하는 이름을 지정하면 의도한 Pod가 아니더라도 부분 문자열이 처음 일치한 Pod를 오류 없이 선택할 수 있었습니다. 이제는 정확한 이름이나 정제된 이름이 일치하는 Pod가 우선 선택되므로, 오류 없이 다른 Pod가 선택될 수 있습니다. 가장 높은 우선순위에서 여러 Pod가 일치하거나 Pod가 없으면 오류가 반환됩니다.

근거: “Prefer exact pod names and exact cleaned names over substring matches when selecting logs. Report ambiguous matches instead of silently selecting the first pod.” https://github.com/meshery/meshery/pull/23666

> - [mesheryctl] Resolve log pod names unambiguously @0xmaster7 (#23666)

### 필터 이름 검색에서 모호한 결과는 선택 요청, 결과가 없으면 오류 반환

- 영향 대상: `mesheryctl filter view`를 사용한 필터 이름 검색

이전에는 일치하는 항목이 여러 개면 첫 번째 결과를 자동으로 열었고, 일치하는 항목이 없으면 찾을 수 없다는 메시지를 로그에 남긴 뒤 성공으로 반환했습니다.

> - fix(mesheryctl): select filters by full name @0xmaster7 (#23580)

### 필터 이름 검색에서 여러 페이지의 결과 조회

- 영향 대상: `mesheryctl filter view`에서 필터 이름으로 검색하는 경우

이전에는 API의 기본 페이지 크기에 맞춰 반환된 결과 페이지에서 검색 결과를 골랐으며, 일치하는 항목이 없어도 검색이 조용히 성공할 수 있었습니다. 이제 여러 필터가 일치하면 선택을 요청하고, 일치하는 항목이 없으면 타입이 지정된 not-found 오류를 반환합니다. 결과를 가져올 수 없거나 결과가 불완전한 경우에도 오류를 보고합니다.

근거: “Searches can retrieve results across multiple pages, and report errors when results cannot be fetched or are incomplete.” https://github.com/meshery/meshery/pull/23580

> - fix(mesheryctl): select filters by full name @0xmaster7 (#23580)

### `utils.MakeRequest`에서 메서드를 바꾸는 리디렉션 거부

- 영향 대상: `utils.MakeRequest`를 통해 요청을 보내는 `mesheryctl`

DELETE, POST 또는 PUT 요청에 301, 302 또는 303 응답이 오면 클라이언트가 본문 없는 GET 요청으로 다시 보낼 수 있었습니다. 그러면 대상 주소의 GET 라우트가 실행되고, 원래 작업은 수행되지 않았는데도 명령이 성공을 보고할 수 있었습니다. 이제 이런 리디렉션은 거부됩니다. 대부분은 `ErrRedirectChangesMethod`를 반환하고, 거부된 302 리디렉션은 `ErrInvalidToken`을 반환합니다. 메서드를 유지하는 리디렉션은 계속 따라갑니다.

근거: “`utils.MakeRequest` used a default `http.Client{}`. net/http answers a 301, 302 or 303 to a DELETE, POST or PUT by re-sending the request as a GET without its body. When the new path also has a GET route, the GET runs and the command reports success.” https://github.com/meshery/meshery/pull/23405

> - [mesheryctl] Report a method-changing redirect instead of following it @Asheesh7298 (#23405)
> - [mesheryctl] Report a method-changing redirect instead of following it @Asheesh7298 (#23405)

### `mesheryctl`의 컨텍스트 참조 토큰 삭제 거부

- 영향 대상: 컨텍스트에서 참조하는 토큰이 있는 meshconfig 구성

이러한 토큰 중 하나에 대해 `system token delete <name>`을 실행하면, 명령은 영향을 받는 컨텍스트 이름을 정렬된 순서로 나열한 뒤 삭제를 거부합니다. 이전에는 토큰 항목만 삭제되어 해당 컨텍스트가 존재하지 않는 토큰을 계속 참조했습니다. 사용되지 않는 토큰은 이전처럼 계속 삭제할 수 있습니다.

근거: “`DeleteTokenFromConfig` refuses to delete a token that a context uses and lists those contexts in sorted order: `token "prod" is still used by context(s) prod, staging; set another token on them first with ...`.” https://github.com/meshery/meshery/pull/23457

> - [mesheryctl] Reject unknown tokens in token set and in-use tokens in token delete @Asheesh7298 (#23457)

### 디자인 내보내기 파일명에 내보내기 유형 반영

- 영향 대상: `mesheryctl design export`를 사용하는 환경, 특히 `oci` 또는 `original` 내보내기 (추정)

이전에는 OCI 내보내기에 확장자가 없었고, `original` Kubernetes 매니페스트 및 Docker Compose 내보내기는 YAML을 담고도 `.tar.gz` 확장자를 사용했습니다. 또한 `helm` 같은 알 수 없는 `--type` 값을 지정하면 현재 디자인이 YAML로 조용히 내보내졌습니다. 이제 `oci` 내보내기에는 `.tar`를, `original` Helm 차트 내보내기에는 `.tar.gz`를, 그 밖의 `original` 내보내기에는 `.yaml`을 사용합니다. `current` 내보내기는 계속 `.yaml`을 사용합니다.

근거: “The Helm and `current` filenames don't change.” https://github.com/meshery/meshery/pull/23447

> - [mesheryctl] Name design export files by type and reject unknown --type @mayank609 (#23447)
> - [mesheryctl] Name design export files by type and reject unknown --type @mayank609 (#23447)

### 설계 내보내기에서 잘못된 `--type` 값 거부

- 영향 대상: `mesheryctl design export` (추정)

이전에는 `helm` 같은 잘못된 값을 입력해도 현재 디자인을 YAML로 조용히 내보냈습니다. 이제 지원하지 않는 값이면 명령어가 `ErrInvalidArgument`를 반환합니다.

근거: “`RunE` checks `--type` against `current`, `original`, `oci` before any network call and returns `ErrInvalidArgument` naming the valid values.” https://github.com/meshery/meshery/pull/23447

> - [mesheryctl] Name design export files by type and reject unknown --type @mayank609 (#23447)

### `view --save`의 일관된 저장 파일명

- 영향 대상: 컴포넌트, 연결, 환경, 필터, 모델, 관계 또는 워크스페이스에 대한 `view --save`

이전에는 리소스 유형에 따라 저장 파일명을 그대로 사용하거나 일부만 정리해 일관성이 없었습니다. 이제 공백과 파일 시스템에 민감한 문자는 밑줄로 바꾸고, 앞뒤 공백은 제거합니다. 사용할 수 없는 이름은 사용 가능한 ID로 대체하며, 일부 항목 유형에서는 `unknown`으로 대체합니다.

근거: “When a name cannot produce a usable filename, the filename falls back to an item ID where available. For several item types, `unknown` is used if neither the name nor ID produces a usable filename.” https://github.com/meshery/meshery/pull/23436

> - fix(mesheryctl): sanitize filesystem-unsafe characters in view --save filenames @ThakurUjjwal1706 (#23436)

### Notification Center UI 페이로드의 직렬화 불가 값 필터링

- 영향 대상: `openNotificationCenter`를 사용하는 Notification Center 통합 (추정)

이전에는 events 슬라이스가 아이콘 컴포넌트를 포함해 페이로드를 받은 그대로 저장했기 때문에 Redux 경고가 발생했습니다. 이제 `Date`, `Map`, `Set`, 클래스 인스턴스, 순환 객체와 같은 직렬화할 수 없는 필드는 제거됩니다. 아이콘은 이름으로 저장하고 렌더링할 때 해당 이름으로 확인합니다.

근거: “This screens the payload in openNotificationCenter before it reaches state. Only serializable values are kept, a Date, Map, Set, class instance or circular object gets dropped. The icon is stored as a name now, and the NotificationCenter resolves it to the component when rendering.” https://github.com/meshery/meshery/pull/23082

> - [UI] Keep non-serializable values out of Notification Center state @krishbuilds01 (#23082)

### Broker 및 MeshSync 리소스의 기본 활성화된 삭제 전 정리

- 영향 대상: 릴리스가 소유한 Broker 또는 MeshSync 커스텀 리소스가 있는 Meshery Operator Helm 차트 설치

이전에는 `helm uninstall`이 오퍼레이터와 이 리소스들을 한 번에 제거해, 오퍼레이터만 제거할 수 있는 finalizer 때문에 리소스가 `Terminating` 상태에 멈췄습니다. 이제 훅은 오퍼레이터가 실행 중일 때 리소스를 삭제하고 90초 기다린 뒤, 필요한 경우 finalizer를 제거합니다. `customResourceCleanup.enabled`를 사용해 정리를 비활성화할 수 있습니다.

근거: “**Symptom.** `helm uninstall` deletes the operator and the Broker/MeshSync resources in one pass. The resources then hang `Terminating` on `broker.meshery.io/finalizer` and `meshsync.meshery.io/finalizer`, which only the operator removes.” https://github.com/meshery/meshery/pull/23259

> - [Helm] Give MeshSync read-only RBAC, expose Broker service values, clean up CRs on uninstall @yi-nuo426 (#23259)

### 페이지네이션을 통한 `GetID` 조회의 후속 디자인 및 필터 일치 항목 검색

- 영향 대상: 디자인 또는 필터가 10,000개를 초과하는 서버를 대상으로 한 짧은 접두사 `mesheryctl` 조회

첫 페이지 이후의 일치 항목을 놓치면 `ValidId`가 모호한 접두사를 고유한 값으로 잘못 판단해 의도치 않은 삭제를 초래하거나, 고유한 접두사를 확인하지 못할 수 있었습니다. 이제 `GetID`는 페이지를 넘겨 ID를 수집하고 중복을 건너뛰며, `totalCount`와 `total_count`를 모두 읽습니다. 50페이지 안에 전체 결과를 확인하지 못하면 불완전 조회 오류 또는 페이지 제한 오류를 반환합니다.

근거: “When resolving short ID prefixes, `GetID` previously requested a single batch of `pagesize=10000` without inspecting total item counts. On servers with more than 10,000 designs or filters, matches past the first page were missed, causing `ValidId` to falsely conclude a prefix was unique (risking unintended deletions in `design delete`) or fail to resolve a unique prefix on subsequent pages.” https://github.com/meshery/meshery/pull/23206

> - [mesheryctl] Paginate ID prefix lookup across multiple pages in GetID @bodapatisaikrishna (#23206)
> - [mesheryctl] Paginate ID prefix lookup across multiple pages in GetID @bodapatisaikrishna (#23206)

### Go `Extensions` 필드를 `Account`로 이름 변경

- 영향 대상: Go에서 `Extensions` 모델 필드를 사용하는 코드 (추정)

이 필드의 이전 이름은 `Acccount`였으며 현재는 `Account`입니다. JSON 태그는 `json:"account,omitempty"`로 유지되어 와이어 및 API 호환성이 보존됩니다.

근거: “The JSON struct tag remains `json:"account,omitempty"`, ensuring 100% wire and API backward-compatibility.” https://github.com/meshery/meshery/pull/23795

> - [Server] Fix misspelled 'Acccount' field in Extensions model @Amansingh0807 (#23795)

### Meshery 프로바이더 검증이 선택한 컨텍스트를 따름

- 영향 대상: 저장된 `current-context`와 다른 컨텍스트를 대상으로 하는 `--context`

이전에는 선택한 컨텍스트가 제공하는 프로바이더가 거부될 수 있었지만, 현재 컨텍스트에서만 제공되는 프로바이더는 받아들여져 선택한 컨텍스트를 재배포하는 데 사용될 수 있었습니다. 이제 유효하지 않은 컨텍스트 이름이면 요청을 보내기 전에 `ErrSettingTemporaryContext`를 반환합니다.

근거: “`system provider switch --context X` redeploys `X`, but `validateProvider` asked the current context's Meshery server for its providers, because `GetProviderInfo` uses `mctlCfg.GetBaseMesheryURL()`, which follows `CurrentContext`. A provider `X` offers could be rejected, and one only the current context's server offers was accepted and then used to redeploy `X`.” https://github.com/meshery/meshery/pull/23786

> - [mesheryctl] Validate the provider on the --context server in provider switch @Eternity0207 (#23786)

### 필터 복제 시 빈 이름 거부

- 영향 대상: 필터 복제

기존 필터를 빈 이름으로 복제하는 요청에는 잘못된 요청 응답이 반환됩니다.

> - [Server] Return 404 for missing filters and validate path UUIDs in filter handlers @antcybersec (#23726)

### 형식이 잘못된 워크스페이스 및 환경 경로 ID에 HTTP 400 반환

- 영향 대상: 워크스페이스 및 환경 경로 ID를 받는 라우트

이전에는 형식이 잘못된 ID가 Local provider까지 전달되어 18개 라우트에서 HTTP 502를 반환했고, 3개 라우트에서는 ID가 nil UUID로 변환되어 HTTP 404를 반환했습니다. 이제 provider를 호출하기 전에 21개 라우트 모두 `models.ErrInvalidUUID`와 함께 HTTP 400을 반환합니다. 형식은 올바르지만 존재하지 않는 ID에는 영향이 없습니다.

근거: “A malformed ID in the path of a workspace or environment route used to reach the provider. With the Local provider that came back as `502 Bad Gateway` on 18 routes and as `404` on 3, where the ID was quietly turned into the nil UUID. All 21 routes now answer `400` with the existing `models.ErrInvalidUUID` (`meshery-server-1432`) before the provider is called.” https://github.com/meshery/meshery/pull/23637

> - [Server] Return 400 for a malformed ID on workspace and environment routes @himanishpuri (#23637)

### 스케줄 핸들러의 빈 입력 거부

- 영향 대상: 스케줄 핸들러 엔드포인트

빈 `scheduleID`로 `DeleteScheduleHandler` 또는 `GetScheduleHandler`를 호출하면, 이제 provider를 조회하기 전에 HTTP 400을 받습니다. `SaveScheduleHandler`에 전송한 디코딩된 본문이 nil이거나 비어 있어도 provider 작업을 진행하기 전에 HTTP 400을 받습니다.

근거: “Added validation in `DeleteScheduleHandler` and `GetScheduleHandler` to ensure `scheduleID` is not empty before querying the provider, returning `http.StatusBadRequest` (400) if empty.” https://github.com/meshery/meshery/pull/23540

> - [Server] Guard nil provider and validate schedule ID across schedule handlers @piyxsh31 (#23540)

### Preference persister 오류에 MeshKit 생성자 적용

- 영향 대상: preference persister를 사용하는 구성 (추정)

읽기, 저장, 생성 실패는 각각 `ErrDBRead`, `ErrDBPut`, `ErrDBCreate`를 사용해 반환됩니다.

근거: “Preference read, save, and delete operations now return more specific errors when they fail.” https://github.com/meshery/meshery/pull/23536

> - [Server] Guard nil database handler, validate userID, and check rows affected in preference persister @piyxsh31 (#23536)

### 설정 파일 닫기 오류 보고

- 영향 대상: `mesheryctl`로 설정 파일을 생성하거나 백업하는 경우

이전에는 해당 경로에서 발생한 닫기 오류를 무시했습니다. 이제 `CreateConfigFile`은 닫기 오류를 반환하고, 백업 경로에서는 해당 오류를 `Log.Fatal`에 전달합니다.

> - [mesheryctl] Fix HTTP response body and file descriptor leaks in utils @muskan-creates352 (#22645)

### 어댑터 배포 및 검증 대기 로직의 응답 이벤트 직접 처리

- 영향 대상: 응답 이벤트를 기다리는 어댑터 배포 또는 검증 흐름 (추정)

이벤트를 읽는 고루틴이 작업을 마치기 전에 대기 로직이 타임아웃되면, 해당 고루틴은 결과를 보내려다 계속 차단된 상태로 남을 수 있었습니다. 이제 대기 루프는 일치하는 성공 또는 오류 이벤트가 오면 반환하고, 반환 시 타이머를 중지합니다.

> - fix: restrict Windows token file permissions @0xmaster7 (#23380)
> - fix: restrict Windows token file permissions @0xmaster7 (#23380)

### `mesheryctl filter delete` 명령에 인수 하나만 허용

- 영향 대상: `mesheryctl filter delete` 명령

이전에는 인수가 없으면 핸들러까지 전달될 수 있었고, 인수가 여러 개여도 인수 검증에서 거부되지 않았습니다. 이제 인수가 없거나 여러 개이면 핸들러가 실행되기 전에 검증 오류가 발생합니다.

근거: “This PR enforces exact argument validation (`cobra.ExactArgs(1)`) on `mesheryctl filter delete`, rejecting invocations with zero arguments or multiple arguments before executing the command handler.” https://github.com/meshery/meshery/pull/23519

> - [mesheryctl] Enforce exact argument validation in filter delete @AdityaChaudhary5412 (#23519)

### mesheryctl에서 `.`이 포함된 컨텍스트 이름 거부

- 영향 대상: 이름에 `.`이 포함된 mesheryctl 컨텍스트 (추정)

이전에는 점이 포함된 컨텍스트를 만들 수 있었지만 Viper가 다시 읽지 못했습니다. 이제 추가에 실패하면 기존 설정이 변경되지 않습니다.

근거: “Adding a context name that contains a period now returns an error and leaves the existing configuration unchanged.” https://github.com/meshery/meshery/pull/23441

> - [mesheryctl] Reject dotted context names @0xmaster7 (#23441)

## 중요 수정 (84)

### 저장되지 않은 필터 변환 및 URL 가져오기에서 잘못 기록되던 저장 이벤트 수정

- 영향 대상: 필터 변환 및 URL 가져오기 요청

`Save`가 false일 때 필터 변환에서 “filters saved” 이벤트가 기록될 수 있었고, 필터를 저장하지 않은 URL 가져오기에서도 저장 이벤트가 기록될 수 있었습니다. 이제 두 작업은 저장하지 않고 정규화된 필터 결과를 반환합니다. `Save`가 true인 URL 가져오기는 계속 필터와 저장 이벤트를 기록합니다.

> - [Server] Prevent false "filters saved" events on unsaved filter conversions @antcybersec (#23711)

### MeshSync 삭제 시 연결된 리소스 데이터도 제거

- 영향 대상: MeshSync 리소스 삭제 또는 클러스터 수준 플러시

이전에는 리소스를 삭제해도 메타데이터, spec, 상태, 레이블, 어노테이션이 남을 수 있었습니다. 결정적 ID 때문에 리소스를 다시 디스커버리하면 고아 레이블이 다시 연결될 수도 있었습니다. 이제 삭제와 연결된 데이터 행도 같은 트랜잭션에서 제거하며, 삭제에 실패하면 일부만 삭제된 상태로 남는 대신 롤백됩니다.

> - [Server] Delete a MeshSync resource's child rows with it @Asheesh7298 (#23216)

### 복제된 디자인의 새 메타데이터와 아이덴티티

- 영향 대상: Local 프로바이더를 사용하는 디자인 복제 (추정)

이전에는 복제본에 원본의 생성 시각, 사용 카운터, 카탈로그 데이터가 그대로 전달됐습니다. 디자인 파일에는 원본의 `id`와 `name`이 유지되고 버전은 원본의 다음 버전으로 올라갔습니다. 이제 복제본은 카운터가 0이고 카탈로그 데이터가 비어 있는 상태로 시작합니다. 디자인 파일의 아이덴티티는 복제본의 것으로 설정되고 버전은 `0.0.1`로 설정됩니다. 원본 디자인은 변경되지 않습니다.

> - [Server] Clone designs and filters as fresh records @Asheesh7298 (#23451)

### 로컬 `GetConnections` 타입 필터 수정

- 영향 대상: 로컬 프로바이더의 `?type=`을 사용하는 연결 목록 쿼리

이전에는 필터가 레거시 `type` 컬럼과 일치하는 항목만 찾았기 때문에, `connection_type`에만 값이 저장된 서버 저장 연결은 반환되지 않았습니다. 이제 해당 연결도 반환하며, registrant 행도 계속 일치합니다.

> - [Server] Filter local connections by connection_type @mayank609 (#23551)

### 저장된 연결 유형과 일치하는 연결 `type` 필터

- 영향 대상: 연결 목록 필터

저장된 연결을 `type`으로 필터링할 때, 저장된 유형이 `connection_type`으로 기록되어 있어 필터가 연결을 찾지 못할 수 있었습니다. 키/값 필터와 JSON 객체 필터를 모두 사용할 수 있으며, 유틸리티 필터는 `connection_type`과 `sub_type`을 지원합니다.

> - [Server] Filter connections by persisted type @0xmaster7 (#23668)

### [드러나지 않던 결함] 패턴 리소스 저장 및 목록 조회 오류 처리 수정

- 영향 대상: 패턴 리소스 저장, 삭제 및 목록 조회 작업

이전에는 저장 또는 목록 조회 중 발생한 일부 데이터베이스 오류를 알리지 않고 성공으로 처리했습니다. 이제 데이터베이스 핸들러를 사용할 수 없거나 리소스가 nil이거나 데이터베이스 작업이 실패하면 오류를 반환합니다.

> - [Server] Harden pattern resource persistence @0xmaster7 (#23667)

### `ReadCapabilitiesForUser`, 행 누락 시 not-found 반환

- 영향 대상: 사용자 capability 읽기

사용자의 `user_capabilities` 행이 없을 때 읽기 결과로 `None`이 반환됐지만, 기대한 결과 없음 오류는 `meshery-server-1307`입니다. 읽기에서 오류가 발생하면 `ProviderCapabilityHandler`는 계속 원격 프로바이더에서 capability를 가져옵니다.

> - [Server] Guard nil capabilities payload and return ErrResultNotFound in UserCapabilitiesPersister @Yasas-Sri (#23644)

### 상태 머신 정리로 재가져온 트래커 항목 보존

- 영향 대상: Kubernetes 컨텍스트와 연결

이전 인스턴스의 비동기 teardown이 진행되는 동안 컨텍스트나 연결을 다시 가져오면, 이전 teardown이 트래커에서 새 상태 머신을 제거할 수 있었습니다. 이제 정리 과정에서는 트래커 항목이 현재 teardown 중인 인스턴스를 가리킬 때만 해당 항목을 제거합니다.

> - [Server] Introduce CompareAndDelete on StateMachine tracker to prevent re-imported connection eviction @nishant-devv (#23632)

### 삭제된 Kubernetes 컨텍스트 및 연결에 대한 MeshSync 정리 수정

- 영향 대상: MeshSync가 관리하는 Kubernetes 컨텍스트 및 연결

이전에는 정리 작업이 중단되어 데이터베이스에 MeshSync 레코드가 남고, 오해를 부르는 컨텍스트 선택 이벤트가 발생할 수 있었습니다. 연결이 끊긴 컨텍스트가 참조 카운트를 부풀릴 수도 있었습니다. 이제 삭제된 컨텍스트가 마지막 활성 참조라면 리소스를 플러시하고, 다른 활성 컨텍스트가 해당 서버를 사용 중이면 리소스를 유지합니다. 또한 연결 상태로 컨텍스트 목록을 필터링할 수 있습니다.

> - [Server] Prevent MeshSync database leak on Kubernetes context deletion @nishant-devv (#23615)

### 컨텍스트 삭제 시 MeshSync 정리 참조 카운팅 수정

- 영향 대상: MeshSync 정리를 수행하는 Kubernetes 컨텍스트 삭제

정리 과정에서 클러스터의 참조 수를 셀 때, 이제 연결이 끊긴 컨텍스트까지 포함한 전체 스냅샷을 사용합니다. 다른 컨텍스트가 서버를 공유하는 동안 MeshSync 데이터를 유지하고, 삭제된 컨텍스트가 마지막으로 연결된 컨텍스트인 경우에만 데이터를 제거합니다. 읽기에 실패하거나 읽은 내용이 불완전하면 정리의 근거로 삼지 않습니다.

> - fix(server): retain cluster context snapshot for cleanup @0xmaster7 (#23579)

### `POST /api/filter` 응답에 디코딩된 필터 포함

- 영향 대상: `POST /api/filter`를 호출하는 클라이언트

저장 성공, 저장 없이 변환, URL 가져오기 요청은 필터가 디코딩되었는데도 `[]`를 반환했습니다. 이제 이 응답에는 필터가 포함됩니다. 단, provider가 `null`을 반환하면 응답은 계속 `[]`입니다.

> - [Server] Return the saved filters from POST /api/filter @antcybersec (#23600)

### 정책 바인딩 셀렉터 상태 격리 문제 수정

- 영향 대상: 동일한 관계 규칙에 바인딩이 여러 개 있는 디자인

후속 반복 처리에서 공유 셀렉터 상태가 앞서 처리한 관계의 `Match.From` 및 `Match.To` 컴포넌트 ID를 덮어쓸 수 있었습니다. 이제 식별된 각 관계가 셀렉터 매치 ID를 별도로 유지하므로, 한 셀렉터를 변경해도 다른 관계의 상태는 바뀌지 않습니다.

> - [Server] Prevent in-place match selector mutation and cross-relationship state corruption in policy binding @nishant-devv (#23585)

### [드러나지 않던 결함] 관계 정리 시 점이 포함된 Kubernetes 키 제거

- 영향 대상: 관계에 의해 변경된 경로 중 점이 포함된 Kubernetes 어노테이션 또는 레이블 키로 끝나는 경로

관계를 삭제할 때 변경된 경로가 점을 포함한 Kubernetes 어노테이션 키나 레이블 키로 끝나면, 주입된 값이 컴포넌트 구성에 남아도 오류나 로그가 기록되지 않을 수 있었습니다. 이제 정리 과정에서 해당 값을 제거합니다. 일반 중첩 경로와 숫자 배열 인덱스 세그먼트는 명시된 동작을 그대로 유지합니다.

> - [Server] Escape literal keys in relationship cleanup paths @Karman580 (#23525)

### [드러나지 않던 결함] SQLite 환경 마이그레이션에서 `purpose` 추가 및 보존

- 영향 대상: SQLite를 백엔드로 사용하는 시스템 데이터베이스와 로컬 프로바이더를 통해 생성하거나 업데이트한 환경

이전에는 `v1beta1` 마이그레이션 후 SQLite의 `environments` 테이블에 `purpose` 열이 없을 수 있어 이후 저장이 실패했고, 업데이트 중에는 환경의 `purpose`가 빈 값으로 덮어써질 수 있었습니다. `v1beta3` 마이그레이션은 이 열을 추가합니다. 기존 레코드는 관리 목적이 아닌 경우 사용자 목적을 사용하고, 새 환경의 기본 목적은 사용자 목적이며, 업데이트 시에는 저장된 목적을 유지합니다.

> - [Server] Honour Environment purpose property and align SystemDatabaseModels to v1beta3 @SachinyadavAug20 (#23429)

### MeshSync 저장 메타데이터의 오래된 레이블과 어노테이션 제거

- 영향 대상: MeshSync 업데이트 경로와 저장소 업데이트 경로에서 처리되는 리소스

기존 리소스를 업데이트할 때(재동기화 포함)와 저장소 업데이트를 생성할 때는 리소스 메타데이터에 더 이상 없는 레이블이나 어노테이션이 남을 수 있었습니다. 이제 해당 경로에서 리소스 메타데이터에 없는 키를 제거해 저장된 메타데이터를 최신 리소스와 일치시킵니다.

> - [Server] Replace stale MeshSync metadata on updates @0xmaster7 (#23440)

### [드러나지 않던 결함] 최선의 노력으로 수행하는 멱등 `utils.ForceCleanupCluster` 정리

- 영향 대상: `utils.ForceCleanupCluster`를 사용하는 Kubernetes 정리 작업(시스템 제거 포함)

이전에는 목록 조회에 실패하면 이후 리소스 종류의 정리가 중단됐고, 삭제 실패가 누락된 채 명령이 성공으로 보고될 수 있었으며, 이미 없는 리소스가 있으면 반복 정리가 실패했습니다. 이제 정리는 리소스 종류별로 계속 진행하고, 실제 목록 조회 및 삭제 실패를 보고하며, 이미 없는 리소스는 성공적으로 제거된 것으로 처리합니다.

> - [mesheryctl] Make ForceCleanupCluster best-effort and idempotent @AnimeshPriyanshu (#23601)

### 필터 이름 전체 일치 선택

- 영향 대상: `mesheryctl filter view`를 사용한 필터 이름 검색

검색 결과에 부분 일치 항목이나 여러 일치 항목이 포함되면, 명령어가 입력한 이름 전체와 일치하는 결과를 찾는 대신 첫 번째 결과를 선택할 수 있었습니다. 이제 대소문자까지 정확히 일치하는 결과를 우선하고, 그다음 대소문자를 구분하지 않는 완전 일치 결과를 선택합니다.

> - fix(mesheryctl): select filters by full name @0xmaster7 (#23580)

### `mesheryctl system reset`의 리셋 대상 수정

- 영향 대상: `mesheryctl system reset`에서 `--config` 사용

이전에는 지정한 파일은 변경되지 않고, 기본 meshconfig에 이름이 지정된 컨텍스트가 추가되면서 `current-context`가 전환됐습니다. 기본 meshconfig가 없으면 리셋도 실패했습니다. 이제 지정한 파일의 해당 컨텍스트를 플랫폼은 유지한 채 기본값으로 리셋하며, 기본 meshconfig는 변경하지 않습니다.

> - [mesheryctl] Reset the meshconfig given by --config in system reset @Eternity0207 (#23500)

### `mesheryctl perf apply`로 성능 테스트 설정 보존

- 영향 대상: `mesheryctl perf apply`와 SMP 구성 파일 또는 저장된 프로필로 구성한 성능 테스트 (추정)

설정을 적용하고 프로필을 만들 때 엔드포인트 URL도 검증합니다.

> - [mesheryctl] Consolidate performance test configuration @0xmaster7 (#23442)

### 컨텍스트별 Compose 파일 버전 선택 수정

- 영향 대상: 현재 meshconfig 컨텍스트와 버전이 다른 `system start --context` 또는 `system reset` 컨텍스트. 버전이 비어 있는 stable 컨텍스트도 포함합니다.

이전에는 X가 현재 meshconfig 컨텍스트와 다른 버전으로 고정되어 있을 때 `system start --context X`를 실행하면 잘못된 릴리스의 Compose 파일을 다운로드할 수 있었습니다. 이제 버전 검증과 Compose 파일 선택은 선택했거나 전달한 컨텍스트의 버전을 기준으로 합니다. 잘못된 컨텍스트 이름은 다운로드 전에 오류로 처리되며, 버전이 비어 있는 stable 컨텍스트는 `latest`로 해석됩니다.

> - [mesheryctl] Use the --context context's version in system start @Eternity0207 (#23461)

### 누락된 Meshery 인증 토큰을 활성 설정 파일에 저장

- 영향 대상: `--config`을 사용하는 Meshery CLI 설정

선택한 컨텍스트가 지정된 파일에 없는 토큰을 가리키면, 이전에는 해당 토큰이 기본 설정 파일에 기록되어 이후 요청이 기본 서버로 전송될 수 있었습니다. 이제 누락된 항목은 선택한 파일에 기록되며, 이후 요청에도 해당 파일이 계속 사용됩니다. `--config`를 지정하지 않으면 항목은 기본 설정 파일에 기록됩니다.

> - [mesheryctl] Add a missing token entry to the --config file, not the default @Asheesh7298 (#23422)

### [드러나지 않던 결함] Meshery 컨텍스트 엔드포인트의 후행 슬래시 제거

- 영향 대상: 엔드포인트가 `/`로 끝나는 `mesheryctl` 컨텍스트

이러한 컨텍스트에서 보낸 요청은 `//api/...`로 시작했습니다. 리디렉션 과정에서 본문 없이 `DELETE`, `POST`, `PUT` 요청이 `GET`으로 다시 전송될 수 있었습니다. `environment delete` 명령은 실제로 아무것도 삭제하지 않았는데도 성공했다고 보고할 수 있었습니다. 이제 기존 구성은 읽을 때 정규화되지만, `context create`는 `--url`을 입력된 그대로 저장합니다.

> - [mesheryctl] Trim trailing slashes from the context endpoint @Asheesh7298 (#23391)

### 연결 대화상자에서 전체 정의 조회

- 영향 대상: 사용 가능한 연결 정의가 25개를 초과하는 Meshery UI Connection Wizard 또는 Connection Configure 모달

이전에는 쿼리가 기본값인 정의 25개만 가져와, 그 수를 넘는 정의는 대화상자에서 사용할 수 없었습니다. 이제 연결 옵션을 채우는 데 사용할 수 있도록 전체 정의가 제공됩니다.

> - [UI] Fetch all connection definitions in Connection Wizard and Configure modals @antcybersec (#23709)

### Workspace Activity 드롭다운의 조직 워크스페이스 전체 요청

- 영향 대상: 워크스페이스가 10개를 초과하는 조직의 Workspace Activity 위젯

이전에는 페이지네이션이 없는 요청에서 워크스페이스 수가 기본값인 10개로 제한되어, 11번째 이후 워크스페이스는 드롭다운에서 사용할 수 없었습니다. 이제 드롭다운에 뷰어가 접근 권한을 가진 모든 워크스페이스가 표시됩니다.

> - [UI] Fetch all workspaces in Workspace Activity widget @antcybersec (#23676)

### `removeDuplicateVersions`에서 관계가 재귀적으로 중첩되는 문제 수정

- 영향 대상: UI 레지스트리에서 `removeDuplicateVersions` 사용

같은 이름과 버전을 가진 중복 모델을 집계할 때, 그룹화 과정에서 관계가 재귀적으로 중첩될 수 있었습니다.

> - [UI] Fix recursive relationship grouping and component array initialization in removeDuplicateVersions @madhavzanwar (#23672)

### UI 레지스트리 관계 중복 제거 수정

- 영향 대상: UI 레지스트리 헬퍼로 관계를 그룹화하는 구성

ID 기준으로 중복 제거하지 않아 결과에 관계가 중복으로 나타날 수 있었습니다. 이제 kind가 없는 관계는 “Unknown”으로 묶입니다.

> - [UI] Fix recursive relationship grouping and component array initialization in removeDuplicateVersions @madhavzanwar (#23672)

### Meshery UI의 Kubernetes 노드 준비 상태 조회 수정

- 영향 대상: Kubernetes 노드 및 조건 배열이 있는 리소스의 Meshery UI 상태 보고

이전에는 `Ready=True` 조건 뒤에 `DiskPressure=False` 같은 다른 조건이 있으면 노드가 준비되지 않은 것으로 표시될 수 있었습니다. 이제 `Ready` 조건의 상태를 기준으로 준비 여부를 보고합니다. `Ready` 조건이 없거나 상태가 `True`가 아니면 여전히 준비된 것으로 보고하지 않습니다.

> - [UI] Fix node readiness condition lookup @0xmaster7 (#23150)

### `canPublishFilter`가 false일 때 Filters 테이블에서 게시 액션 숨김

- 영향 대상: `canPublishFilter`가 false일 때 Filters 테이블의 행

이전에는 필터가 게시되지 않았거나 프로바이더가 게시를 지원하지 않아도 해당 상태의 모든 행에 게시 취소 버튼이 표시됐습니다. `canPublishFilter`가 true이면 각 행에 필터의 게시 상태에 맞는 액션이 표시됩니다.

> - [UI] Hide Publish and Unpublish actions when canPublishFilter is false @antcybersec (#23651)

### `normalizeURI`의 빈 입력 및 문자열이 아닌 입력 처리 수정

- 영향 대상: 릴리스 노트에 언급 없음

이전에는 입력이 비어 있거나 문자열이 아니면 예외가 발생하거나 `/`를 반환할 수 있었습니다. 이제 이런 입력에는 빈 문자열을 반환하며, 비어 있지 않은 경로는 기존 정규화 동작을 유지합니다.

> - [UI] Handle invalid input in normalizeURI @0xmaster7 (#23605)

### 배포 대상 선택기에 모든 연결 표시

- 영향 대상: 연결이 10개를 초과하는 환경의 배포 대상 선택기

이전에는 선택기에 최근 업데이트된 연결 10개만 전달되어 오래된 Kubernetes 연결이 누락되거나 선택 개수와 전체 개수의 카운터가 잘못 표시될 수 있었습니다. 이제 모든 연결이 전달되므로 모든 Kubernetes 연결을 선택할 수 있으며, Kubernetes가 아닌 연결은 Kubernetes 선택 개수에 포함되지 않습니다.

> - [UI] List every connection of an environment in the deployment target picker @ChackoPAbraham19 (#23590)

### 조직 사용자 페이지 크기 전달 수정

- 영향 대상: 워크스페이스 팀 구성원 페이지 크기를 선택한 조직 사용자 목록

이전에는 요청에서 선택한 크기를 엔드포인트가 허용하는 `pageSize`가 아니라 `pagesize`로 보내 오류 없이 선택한 크기가 무시될 수 있었습니다. 이제 엔드포인트가 선택한 크기를 적용합니다. 페이지당 사용자 10명, 20명, 25명 옵션을 테스트했습니다.

> - fix(ui): forward organization user page size @0xmaster7 (#23576)

### Kubernetes 메모리 수량 스케일링 수정

- 영향 대상: `Pi`, `P`, `Ei` 또는 `E` 접미사가 붙은 Kubernetes 메모리 수량을 정규화하는 UI 경로 (추정)

이전에는 `Pi`와 `P` 수량이 `1 Bytes`로 표기될 수 있었고, `Ei`와 `E` 값은 각각 1024배와 1000배씩 적게 계산됐습니다. 이제 `Pi`와 `Ei`에는 이진 스케일을, `P`와 `E`에는 십진 스케일을 사용합니다. 예를 들어 `1Ei`는 `1.15 EB`로 표기됩니다.

> - [UI] Correct Pi, P, Ei, and E memory quantity conversion @Veditha08 (#23505)

### 워크스페이스 테이블 camelCase 필드 매핑 수정

- 영향 대상: 워크스페이스 테이블

camelCase 워크스페이스 행에서는 이전에 소유자가 없는 워크스페이스의 소유자 아바타와 조직 이름이 표시되지 않았고, 소유자 링크가 `/user/undefined`를 가리켰으며, 일부 열 표시 설정이 작동하지 않았습니다. 이제 소유자 및 조직 데이터가 표시되고, 프로필 링크에 소유자 필드를 사용하며, 열 표시 키가 테이블의 열 이름과 일치합니다.

> - [UI] Read camelCase owner fields in the Workspaces table @Asheesh7298 (#23453)

### 가시성 및 메모 변경 후 View Info 정보 갱신

- 영향 대상: View Info 모달에서 조회하거나 업데이트하는 워크스페이스 뷰

가시성이나 메모를 변경한 뒤에도 모달에 이전 가시성이나 오래된 메모가 표시될 수 있었고, 가시성 변경 후에는 모달 뒤의 목록이 새로고침되지 않았습니다. 이제 모달은 가져온 메모가 있으면 이를 사용하고, 데이터를 다시 가져오는 동안에도 편집 내용을 보존합니다. 가시성을 변경하면 페이지가 나뉜 뷰 목록을 무효화하지 않고 새로고침합니다.

> - [UI] Refresh cached views after visibility, notes and delete changes @Asheesh7298 (#23479)

### 삭제된 뷰의 캐시 항목 무효화

- 영향 대상: 워크스페이스 뷰 (추정)

삭제된 뷰를 다시 요청했을 때 캐시에 저장된 결과가 남아 있으면, 삭제가 반영되지 않은 결과가 캐시에서 반환될 수 있었습니다.

> - [UI] Refresh cached views after visibility, notes and delete changes @Asheesh7298 (#23479)

### 구조화된 메타데이터 포맷팅에서 숫자 및 불리언 값 보존

- 영향 대상: 숫자 또는 불리언 값을 포함하는 구조화된 알림 또는 데이터 메타데이터 (추정)

이전에는 일반 알림 및 데이터 포맷터가 숫자와 불리언 메타데이터를 빈 값으로 처리해 버렸습니다. 비어 있지 않은 문자열과 함께 있는 `0`과 `false`도 버렸습니다. 이제 해당 값을 문자열로 렌더링하고, `0`과 `false`를 사용자 지정 프로퍼티 포맷터에 전달합니다.

> - [UI] Preserve numeric and boolean values in structured metadata @harshitethic (#23449)

### 자격 증명 테이블 날짜 표시 수정

- 영향 대상: 자격 증명 테이블에서 `createdAt` 및 `updatedAt` 필드가 있는 행

날짜 열은 `created_at`과 `updated_at`을 사용했지만 API는 `createdAt`과 `updatedAt`을 반환해, 모든 행에 자격 증명의 날짜 대신 페이지를 불러온 시각이 표시됐습니다. 이제 테이블에 실제 생성일과 수정일이 상대 시간 형식으로 표시되며, 날짜 위에 마우스를 올리면 전체 날짜를 확인할 수 있습니다.

> - [UI] Show real dates in the Credentials table @Asheesh7298 (#23459)

### [드러나지 않던 결함] Meshery `schemaValidator`의 검증 결과 복사본 반환

- 영향 대상: Meshery UI 컴포넌트 검증 및 스키마 검증 결과를 참조로 비교하는 셀렉터

이전에는 검증 과정에서 기존 결과 객체를 변경한 뒤 같은 참조를 반환했습니다. 따라서 참조를 비교하는 셀렉터가 업데이트를 감지하지 못해 오류 없이 결과가 오래된 상태로 남을 수 있었습니다. 이제 셀렉터가 업데이트를 감지할 수 있으며, 기존 실패 메시지 문자열은 그대로 유지됩니다.

> - fix(ui): handle validation error taps in every design validator state @yi-nuo426 (#23409)

### WebSocket 클라이언트가 없어도 완료되는 Docker Extension 토큰 요청

- 영향 대상: `/token/store` 또는 `DELETE /token`을 사용하는 Docker Extension 인증

이전에는 Extension UI가 `/ws`를 열기 전에 브라우저에서 로그인하면 `/token/store` 요청이 대기 상태에 빠졌고, WebSocket 연결이 끊긴 뒤 로그아웃하면 `DELETE /token` 요청이 대기 상태에 빠졌습니다. 이제 연결된 WebSocket이 없어도 토큰 저장과 삭제가 완료되며, 연결된 클라이언트에는 인증 상태 알림이 계속 전송됩니다.

> - [Docker Extension] Don't hang token store and logout when no websocket client is connected @CyberRik (#23765)

### Docker Extension 프록시 동시성 및 WebSocket 종료 경합 수정

- 영향 대상: Docker Extension 프록시 설정 (추정)

`token`과 `authWsChan`에 동시에 접근할 때 경합이 발생할 수 있었고, 전송 중 채널을 닫으면 “닫힌 채널에 전송” 패닉이 발생할 수 있었습니다. 이제 이전 WebSocket을 닫아도 가장 최근 클라이언트의 인증 업데이트가 방해받지 않습니다.

> - [Docker Extension] Don't hang token store and logout when no websocket client is connected @CyberRik (#23765)

### Meshery 필터 핸들러의 nil 및 누락 값 오류 수정

- 영향 대상: Meshery 필터 핸들러

이 핸들러는 사용자나 provider가 없거나, 이벤트 생성 중 `SystemID`가 nil이거나, 요청 컨텍스트의 토큰이 문자열이 아니거나, 선택적 의존성이 nil인 경우 패닉이 발생하거나 nil 역참조가 발생할 수 있었습니다. 지정된 변경 엔드포인트에서 사용자가 없으면 이제 HTTP 401을 반환하고, provider가 없으면 HTTP 500과 `ErrNilProvider`를 반환합니다. 유효하지 않은 토큰 값에는 HTTP 500과 `ErrFetchToken`을 반환하며, `SystemID`가 nil이면 이벤트 생성에 `uuid.Nil`을 사용합니다. nil 선택적 의존성도 가드합니다.

> - [Server] Guard nil user, nil provider, and nil SystemID in filter handlers @antcybersec (#23759)

### Meshery 패턴 핸들러의 컨텍스트 누락 패닉 수정

- 영향 대상: Meshery 패턴 핸들러

사용자, provider 또는 `SystemID`가 없으면 핸들러에서 패닉이 발생할 수 있었습니다. 명시된 사용자 누락 사례는 이제 401을 반환하고, provider 누락 사례는 500을 반환합니다. 시스템 ID가 없는 경우 이벤트를 생성하는 작업은 `uuid.Nil`을 사용하며, 컨텍스트 토큰이 없는 패턴 목록 요청도 안전하게 처리됩니다.

> - [Server] Guard nil user, nil provider, and nil SystemID across pattern handlers @antcybersec (#23755)

### 연결 핸들러 nil 포인터 크래시 수정

- 영향 대상: 연결 등록, 저장, 목록 조회, 조회, 업데이트 및 상태 알림 핸들러

필수 사용자나 프로바이더가 nil이거나 이벤트 생성 중 `SystemID`가 nil이면 연결 작업에서 panic이 발생할 수 있었습니다. 이제 사용자가 없으면 401, 프로바이더가 없으면 500을 반환하고, 시스템 식별 정보가 없으면 `uuid.Nil`을 사용합니다.

> - [Server] Guard nil user, nil provider, and nil SystemID in connections handlers @antcybersec (#23752)

### K8sconfig 핸들러 nil 포인터 패닉 수정

- 영향 대상: K8sconfig 가져오기, 컨텍스트 디스커버리, Kubernetes ping 및 등록 핸들러

사용자, provider 또는 시스템 ID가 없거나 로거가 nil이면 해당 핸들러에서 nil 포인터 패닉이 발생할 수 있었습니다. 이제 사용자가 없으면 HTTP 401을 반환하고, provider가 없으면 `ErrNilProvider()`와 함께 HTTP 500을 반환합니다. 지정된 경로에서는 시스템 ID가 없을 때 `uuid.Nil`을 기본값으로 사용하며, 로거 사용은 nil 여부를 확인하도록 보호합니다.

> - [Server] Guard nil user, nil provider, and nil SystemID in k8sconfig handlers @antcybersec (#23750)

### 자격 증명 핸들러의 nil 값 관련 오류 수정

- 영향 대상: 자격 증명 저장, 업데이트, 목록 조회, 단건 조회 및 삭제 핸들러

사용자나 프로바이더가 없거나 로깅을 사용할 수 없으면 nil 역참조 또는 예상치 못한 오류가 발생할 수 있었습니다. 이제 사용자가 없으면 `SaveUserCredential`, `UpdateUserCredential`, `GetUserCredentials`에서 HTTP 401을 반환합니다. 다섯 가지 자격 증명 작업에서 프로바이더가 없으면 `ErrNilProvider()`와 함께 HTTP 500을 반환하며, 로깅을 사용할 수 없어도 더는 오류가 발생하지 않습니다.

> - [Server] Guard nil user and nil provider in credentials handlers @antcybersec (#23748)

### 필터 핸들러의 UUID 검증 및 오류 응답 수정

- 영향 대상: 필터 조회, 파일 다운로드, 복제 및 삭제 엔드포인트

형식이 잘못된 필터 경로 ID에는 이제 잘못된 요청 응답을 반환합니다. 조회하거나 복제하려는 필터가 없으면 찾을 수 없음 응답을 반환합니다. 이전에는 조회 요청에서 초기화되지 않은 zero-struct와 원시 오류를 함께 반환할 수 있었습니다. Provider 조회 오류의 상태 매핑에는 이제 `providerStatusOrInternal(err)`을 사용합니다.

> - [Server] Return 404 for missing filters and validate path UUIDs in filter handlers @antcybersec (#23726)

### 관계 셀렉터의 모델 이름 불일치 수정

- 영향 대상: `models/`의 관계 셀렉터

남아 있던 오타가 있거나 등록되지 않은 이름 때문에 `server/policies`의 `TestRelationshipSelectorsNameRegisteredModels` 테스트가 실패했습니다. 예를 들어 `azure-container-service` 대신 `azure-conatiner-service`가 있었습니다.

> - [Models] Fix remaining unrenamed relationship selector model names @antcybersec (#23720)

### Local provider 디자인 조회 응답 수정

- 영향 대상: Local provider의 `GET /api/pattern/{id}` 라우트

요청한 디자인이 없으면 이전에는 라우트가 빈 디자인 형식의 응답 본문과 함께 400을 반환했지만, 이제는 MeshKit 오류 본문과 함께 404를 반환합니다. 형식이 잘못된 ID는 계속 400을 반환하지만, 이제 빈 디자인 대신 `meshery-server-1432` 잘못된 UUID 오류 본문을 반환합니다.

> - [Server] Return 404 for a design that does not exist @himanishpuri (#23688)

### 워크스페이스 API의 GET 및 PUT 요청에서 워크스페이스 누락 응답 수정

- 영향 대상: 워크스페이스 API 요청

형식은 올바르지만 존재하지 않는 워크스페이스 ID로 `GET` 또는 `PUT /api/workspaces/{id}` 요청을 보내면 `502 Bad Gateway`가 반환됐습니다. 이제 이러한 요청에는 `404`가 반환되며, 그 밖의 워크스페이스 조회 오류는 변경되지 않았습니다.

> - [Server] Return 404 for a workspace that does not exist @himanishpuri (#23686)

### 정책 이벤트 영속화 고루틴의 패닉으로 서버 프로세스가 더 이상 종료되지 않음

- 영향 대상: `EvaluateRelationshipPolicy`를 사용하는 정책 평가

이 수정 전에는 정책 평가 중 별도 `provider.PersistEvent` 고루틴에서 패닉이 발생하면 서버 프로세스가 종료될 수 있었습니다. 이제 해당 패닉을 복구하고, 로거를 사용할 수 있으면 로그로 기록합니다.

> - [Server] Guard unchecked nil dereferences, unbounded body reads, and detached goroutine panics in EvaluateRelationshipPolicy @Amansingh0807 (#23664)

### Meshery 종료 시 SSE 스트림 종료

- 영향 대상: providers stream, adapter events, events subscribe 및 controllers status subscribe SSE 라우트

이전에는 활성 스트림 때문에 종료가 `httpShutdownTimeout`의 전체 30초 동안 지연될 수 있었고, 프로바이더 세션과 데이터베이스가 닫히는 동안에도 핸들러가 계속 실행됐습니다. 이제 종료 시 스트림의 요청 컨텍스트를 취소해 스트림을 끝냅니다. 드레이닝 시간이 초과되면 남은 연결을 닫지만, 해당 핸들러가 반환할 때까지 기다리지는 않습니다.

> - [Server] End SSE streams when the server starts shutting down @SandstromPL (#23655)

### `WriteCapabilitiesForUser` nil 데이터 패닉 수정

- 영향 대상: nil capability 데이터로 `UserCapabilitiesPersister.WriteCapabilitiesForUser`를 호출하는 경우

이전에는 데이터가 nil이면 nil 포인터 패닉이 발생했습니다. 이제 이러한 호출은 `ErrNilConfigData`를 반환합니다.

> - [Server] Guard nil capabilities payload and return ErrResultNotFound in UserCapabilitiesPersister @Yasas-Sri (#23644)

### 스키마가 없는 이름의 스키마 리소스 조회 시 HTTP 404 반환

- 영향 대상: `GET /api/schema/resource/{resourceName}` 호출

리소스 이름이 비어 있거나 알 수 없거나 다른 이유로 인식되지 않는 요청은 HTTP 500을 반환했습니다. 이제 이런 요청은 HTTP 404를 반환하며, 인식된 스키마는 계속 JSON으로 반환됩니다.

> - [server] return 404 for unknown resource schemas @rakesh0x (#23635)

### nil provider 검사 추가

- 영향 대상: 스케줄 핸들러

요청이 `provider == nil`인 상태로 이 핸들러 중 하나에 도달하면, provider를 역참조하는 대신 HTTP 500과 함께 `ErrNilProvider()`를 반환합니다.

> - [Server] Guard nil provider and validate schedule ID across schedule handlers @piyxsh31 (#23540)

### AWS 및 Azure 클라우드 리소스 관계 모델 이름 수정

- 영향 대상: AWS 및 Azure 클라우드 리소스 관계 정의 (추정)

일부 정의에서 `azure-conatiner-service`와 `aws-vpccni-controller` 등의 모델 이름을 잘못 사용했습니다. 수정된 매핑은 클라우드 리소스를 적절한 모델과 연결합니다.

> - fix(server): retain cluster context snapshot for cleanup @0xmaster7 (#23579)

### 시드된 관계 셀렉터 이름 수정

- 영향 대상: 이름이 지정된 모델의 시드 버전에서 영향을 받은 셀렉터를 사용하는 관계 (추정)

일부 셀렉터는 부분 문자열로만 일치했고, 다른 셀렉터는 어떤 모델과도 일치하지 않아 해당 관계가 잘못 일치하거나 전혀 적용되지 않을 수 있었습니다. 중복 셀렉터 하나도 제거했습니다.

> - [Models] Fix relationship selectors that name models that do not exist @BarbieRajput (#23566)

### 사용자 핸들러의 nil provider 역참조 수정

- 영향 대상: `GetUserByIDHandler`, `GetUsers`, `UserPrefsHandler`, `ShareDesignHandler` 또는 `ShareFilterHandler`가 처리하는 요청

provider가 nil이면 이러한 요청에서 nil 포인터 역참조가 발생할 수 있었습니다. 이제는 대신 HTTP 500 오류가 반환됩니다.

> - [Server] Guard nil provider and nil user dereferences across user handlers @piyxsh31 (#23543)

### `UserPrefsHandler` POST의 사용자 누락 처리 수정

- 영향 대상: `UserPrefsHandler`가 처리하는 POST 요청

사용자 컨텍스트 없이 POST 요청이 들어오면 HTTP 400을 반환합니다.

> - [Server] Guard nil provider and nil user dereferences across user handlers @piyxsh31 (#23543)

### 잘못된 성능 프로파일 ID의 provider 접근 전 거부

- 영향 대상: `GetPerformanceProfileHandler` 및 `DeletePerformanceProfileHandler` 엔드포인트

이전에는 형식이 잘못된 UUID가 아닌 ID가 provider 내부에 전달되어 일반적인 HTTP 500 오류를 일으킬 수 있었습니다. 이제 이러한 요청은 provider나 GORM에 접근하기 전에 `ErrInvalidUUIDValueCode`로 거부됩니다.

> - [Server] Guard invalid UUID status codes, missing 404 responses, and unchecked token extraction in performance profile handlers @Amansingh0807 (#23561)

### `GetPerformanceProfileHandler`에서 누락된 프로필에 대한 HTTP 404 처리

- 영향 대상: `GetPerformanceProfileHandler` 호출자

요청한 프로필이 로컬 GORM persister 또는 원격 provider에 없을 때, 이전에는 HTTP 500 서버 오류로 보고했습니다. 이제 구조화된 MeshKit 오류와 함께 HTTP 404를 반환합니다.

> - [Server] Guard invalid UUID status codes, missing 404 responses, and unchecked token extraction in performance profile handlers @Amansingh0807 (#23561)

### 성능 프로필 핸들러의 프로바이더 HTTP 상태 보존

- 영향 대상: `SavePerformanceProfileHandler`, `GetPerformanceProfilesHandler`, `DeletePerformanceProfileHandler`, `GetPerformanceProfileHandler`

프로바이더 오류에 업스트림 HTTP 상태가 포함되어 있어도 핸들러가 일반 HTTP 500을 반환할 수 있었습니다. 이제 프로바이더의 HTTP 상태를 반환하며, 상태가 없는 오류에는 내부 오류 폴백을 계속 사용합니다.

> - [Server] Guard invalid UUID status codes, missing 404 responses, and unchecked token extraction in performance profile handlers @Amansingh0807 (#23561)

### 성능 프로파일 핸들러의 토큰 처리 수정

- 영향 대상: 로컬 또는 원격 프로바이더를 사용하는 성능 프로파일 요청

컨텍스트 토큰이 없으면 패닉이 발생할 수 있었습니다. 원격 프로바이더에서는 토큰이 없거나 비어 있으면 이제 HTTP 401과 함께 `ErrFetchToken`을 반환합니다. 로컬 프로바이더에서는 빈 토큰을 허용합니다.

> - [Server] Guard invalid UUID status codes, missing 404 responses, and unchecked token extraction in performance profile handlers @Amansingh0807 (#23561)

### 세션 동기화로 어댑터가 복원되는 문제 방지

- 영향 대상: 세션 동기화를 사용하는 어댑터 관리

어댑터를 `DELETE /api/system/adapter/manage?adapter=<loc>`로 삭제하면 로컬 환경설정 슬라이스에서만 제거되어 다음 세션 동기화 때 복원될 수 있었습니다. 이제 어댑터를 `h.config.AdapterTracker`에서도 제거하므로 복원되지 않습니다.

> - [Server] Remove adapter from AdapterTracker on delete and prevent session sync resurrection @nishant-devv (#23555)

### `MeshOpsHandler` kubeconfig 생성 실패 응답 수정

- 영향 대상: Kubernetes 컨텍스트의 kubeconfig 생성

Kubernetes 컨텍스트의 kubeconfig 생성에 실패하면 HTTP 상태 코드나 오류 메시지 없이 클라이언트 연결이 네트워크 타임아웃이 발생할 때까지 멈췄습니다. 이제 핸들러는 `ErrInvalidKubeConfig`를 로그에 남기고, 구조화된 오류 응답과 함께 HTTP 400을 반환합니다.

> - [Server] Remove adapter from AdapterTracker on delete and prevent session sync resurrection @nishant-devv (#23555)

### 성능 프로파일 삭제 시 프로바이더 상태 코드 유지

- 영향 대상: 성능 프로파일 삭제

삭제에 실패하고 원격 프로바이더가 403이나 409 같은 HTTP 상태 코드를 반환해도 핸들러는 이전에 500을 반환했습니다. 이제 해당 상태 코드를 그대로 반환합니다. 프로바이더 상태 코드가 없는 실패에는 계속 500을 반환하며, 찾을 수 없음 처리는 변경되지 않았습니다.

> - [Server] Preserve the provider status when deleting a performance profile fails @Shikhyy (#23549)

### 빈 부하 테스트 이름 처리 수정

- 영향 대상: 쿼리 매개변수 또는 SMP 구성에 빈 이름을 지정한 부하 테스트 요청

이전에는 두 입력 경로 모두 nil 포인터 패닉을 일으켰습니다. 이제 이러한 요청은 기존 MeshKit 빈 이름 오류와 함께 HTTP 400을 반환합니다.

> - [Server] Fix blank load-test name panic @0xmaster7 (#23502)

### 디자인 패키지 내보내기 응답 수정

- 영향 대상: `?pkg=true`를 사용하는 디자인 패키지 내보내기

이전에는 압축되지 않은 YAML이 tar 스트림 뒤에 이어졌고, 디자인 YAML이 이스케이프된 스칼라로 직렬화될 수 있었으며, MIME 타입과 파일 이름 헤더가 아카이브와 일치하지 않았습니다. 이제 응답에 올바른 형식의 디자인 콘텐츠가 포함되고, tar 콘텐츠 타입과 `.tar` 첨부 파일 이름이 사용됩니다.

> - [Server] Prevent stream corruption and double-serialization in design package export @nishant-devv (#23497)

### Fetch-results 토큰 및 폼 처리 수정

- 영향 대상: 5개 fetch-results 엔드포인트

요청 컨텍스트에 토큰이 없거나 토큰 형식이 잘못되면 패닉이 발생할 수 있었고, fetch 토큰이 없는 요청도 provider에 전달될 수 있었습니다. 이제 사용할 수 있는 fetch 토큰이 없는 요청에는 오류 응답을 반환합니다. 형식이 잘못된 폼 데이터는 이전에 HTTP 403을 반환했지만, 이제 HTTP 400을 반환합니다.

> - [Server] Guard unchecked context type assertions, nil provider panics, and 403 form parsing errors in fetch results handlers @Amansingh0807 (#23435)

### Fetch-results 핸들러의 provider 및 결과 오류 안전 처리

- 영향 대상: fetch-results 엔드포인트

이전에는 nil provider를 역참조할 수 있었고, `GetResultHandler`와 `FetchSingleSmiResultHandler`에서 결과가 없거나 비어 있는지 확인하지 않았습니다. 조회 또는 변환에 실패하면 유효하지 않은 결과 데이터가 반환될 수도 있었습니다. 이제 nil provider에는 HTTP 500을 반환하고, 두 핸들러에서 결과가 없으면 HTTP 404를 반환합니다. 조회 또는 변환에 실패해도 유효하지 않은 결과 데이터는 반환하지 않습니다.

> - [Server] Guard unchecked context type assertions, nil provider panics, and 403 form parsing errors in fetch results handlers @Amansingh0807 (#23435)

### 백그라운드 디스커버리에서 최신 연결 상태 보존

- 영향 대상: 백그라운드 디스커버리가 진행 중인 연결

사용자가 연결을 끊었을 때 디스커버리나 `NOTFOUND` 프로브가 진행 중이면, 연결 상태가 `CONNECTED`로 되돌아가고 오래된 resolution이 저장될 수 있었습니다. 이제 연결은 `DISCONNECTED` 상태로 유지되며, 오래된 상태 쓰기와 resolution 및 이벤트는 거부됩니다.

> - [Server] Persist Discovery resolutions only when the stored status still matches @dropps07 (#23294)

### Results 및 성능 프로파일 핸들러 패닉 수정

- 영향 대상: Results 및 성능 프로파일 엔드포인트

토큰 컨텍스트가 없거나 토큰이 문자열이 아닌 요청은 패닉을 일으킬 수 있었고, provider가 nil이면 크래시가 발생할 수 있었습니다. 이제 핸들러는 토큰 추출 중 패닉이 발생하지 않도록 처리하며, provider를 사용할 수 없으면 HTTP 500을 반환합니다.

> - [Server] Guard nil provider and unsafe token extraction in results and performance handlers @piyxsh31 (#23420)

### 컨텍스트 조회 및 삭제 요청에서 잘못된 UUID 거부

- 영향 대상: `GetContext` 및 `DeleteContext` 요청

이전에는 프로바이더 조회 또는 상태 머신 초기화 전에 핸들러 경계에서 ID를 검증하지 않았습니다. 이제 형식이 잘못된 문자열과 nil UUID는 두 단계 중 어느 것도 수행하기 전에 `models.ErrInvalidUUID`와 함께 HTTP 400을 반환합니다.

> - [Server] Validate context ID and guard nil pointer dereferences in contexts handler @piyxsh31 (#23424)

### 컨텍스트 핸들러 nil 포인터 크래시 수정

- 영향 대상: 컨텍스트 조회 및 삭제 핸들러

`GetAllContexts`, `GetContext` 또는 `DeleteContext`에서 프로바이더가 nil이면 nil 포인터 크래시가 발생할 수 있었지만, 이제 해당 요청은 HTTP 500을 반환합니다. `DeleteContext`에서 사용자 또는 시스템 식별자가 누락되거나 상태 머신 트래커가 nil이면 서버 패닉이 발생할 수 있었지만, 이제 이런 경우 역참조 패닉이 발생하지 않습니다.

> - [Server] Validate context ID and guard nil pointer dereferences in contexts handler @piyxsh31 (#23424)

### `mesheryctl` 프로바이더 응답 본문 누수 수정

- 영향 대상: `mesheryctl`을 사용한 프로바이더 정보 조회

`GetProviderInfo`가 성공 응답 검사를 통과한 뒤에는 디코딩이 성공했든 실패했든 응답 본문이 열린 채로 남았습니다. 이제 사용 후 응답 본문을 닫습니다.

> - [mesheryctl] Fix HTTP response body and file descriptor leaks in utils @muskan-creates352 (#22645)

### `InstallprereqDocker`의 docker-compose 응답 본문 닫기

- 영향 대상: docker-compose 릴리스 정보를 가져오는 `mesheryctl` Docker 사전 요구 사항 검사를 사용하는 설정

검사에서 docker-compose 릴리스 정보를 가져올 때, 응답 본문을 읽은 뒤에도 열린 상태로 남아 있었습니다. 버전 확인에 실패할 때의 기존 폴백 동작은 그대로 유지됩니다.

> - [mesheryctl] Fix HTTP response body and file descriptor leaks in utils @muskan-creates352 (#22645)

### `mesheryctl perf result`에서 nil `TestStartTime` 패닉 수정

- 영향 대상: `TestStartTime`이 설정되지 않은 성능 결과

테이블 변환이나 확장된 `--view` 출력에서 `TestStartTime`이 설정되지 않은 결과를 처리할 때 시작 시간을 역참조하면서 패닉이 발생할 수 있었습니다. 이제 두 경우 모두 None을 표시합니다.

> - [mesheryctl] Guard nil TestStartTime, fix dead check, and standardize timestamp in perf result (#23727) @muskan-creates352 (#23729)

### `mesheryctl` Kubernetes 로그 follow 출력의 완전한 줄 보존

- 영향 대상: `mesheryctl`로 follow하는 Kubernetes 로그

로그 한 줄이 여러 스트림 읽기에 걸쳐 나뉘어도 이제 완전한 한 줄로 출력됩니다. EOF에 도달했을 때 끝에 개행 문자가 없는 나머지 내용은 파드 이름과 개행 문자를 붙여 출력합니다. follow하지 않는 Kubernetes 로그와 Docker 로그는 변경되지 않았습니다.

> - [mesheryctl] Preserve followed Kubernetes log lines @0xmaster7 (#23705)

### 로컬 디자인 가져오기 파일명 처리 수정

- 영향 대상: Windows에서 가져오기 이름을 지정하지 않은 로컬 디자인 가져오기

이전에는 `path.Base`가 Windows 경로 구분자를 인식하지 못해 가져온 파일에 잘못된 파일명과 기본 디자인 이름이 사용될 수 있었습니다. 이제 가져오기는 `filepath.Base`를 사용해 두 이름을 모두 올바르게 구합니다.

> - [mesheryctl] Fix design import filename on Windows @0xmaster7 (#23665)

### EventBroadcaster 구독자 항목 누수 수정

- 영향 대상: Meshery 서버에서 EventBroadcaster 구독을 사용하는 설정 (추정)

사용자의 마지막 리스너가 구독을 취소해도 `Broadcast.clients`에 구독자 항목이 계속 남아 있었습니다. 이제 비어 있는 항목을 제거하며, 항목 제거 후 새 구독이 들어오는 경우와 구독 변경이 동시에 일어나는 경우에도 이벤트 알림이 중단되지 않습니다.

> - [Server] Prune empty subscriber entries from EventBroadcaster and [mesheryctl] fix portforward errOut ineffassign @Atharva-Mendhulkar (#23516)

### mesheryctl 토큰 경로 해석 수정

- 영향 대상: meshconfig 토큰의 `location`이 절대 경로 또는 `~/` 경로로 설정된 경우

인증이 필요한 명령이 경로를 잘못 `~/.meshery` 아래에 결합해 `Authentication token not found` 오류와 함께 실패했습니다. 이제 로그인 및 로그아웃에서 사용하는 위치와 동일한 위치로 경로를 해석합니다. 파일 이름만 지정하면 계속 `~/.meshery` 아래의 경로로 해석됩니다.

> - [mesheryctl] Resolve token locations for requests the way login does @Asheesh7298 (#23475)

### 시스템 시작 시 Docker 엔드포인트 확인 수정

- 영향 대상: localhost 또는 원격 컨텍스트 엔드포인트를 사용해 `mesheryctl system start -p docker`로 Docker를 시작하는 경우

Meshery가 실행 중이어도 확인 과정에서 잘못된 주소로 연결을 시도해 30회 확인을 모두 마친 뒤 엔드포인트에 접근할 수 없다고 보고할 수 있었습니다. 이제 선택한 엔드포인트의 포트가 응답하면 확인에 성공할 수 있습니다.

> - [mesheryctl] Wait on a dialable endpoint in system start on Docker @Eternity0207 (#23430)

### `removeDuplicateVersions`의 중복 모델 집계 수정

- 영향 대상: UI 레지스트리 헬퍼 `removeDuplicateVersions`

이름과 버전이 같은 중복 모델을 결합할 때 `allComponents`와 `allRelationships`가 배열이 아니라 `{}`로 초기화되었습니다. 이제 두 값이 배열로 초기화되어 모델의 컴포넌트와 관계가 결합됩니다.

> - [UI] Fix recursive relationship grouping and component array initialization in removeDuplicateVersions @madhavzanwar (#23672)

### Filters 테이블 타임스탬프 표시 수정

- 영향 대상: Filters 테이블의 필터 행

테이블의 snake_case 열 이름이 `GET /api/filter`에서 반환하는 camelCase 필드와 일치하지 않으면 각 행에 타임스탬프 대신 현재 시각이 표시됐습니다. 이제 셀 값이 undefined인 행에는 실제 `createdAt` 및 `updatedAt` 타임스탬프가 표시됩니다.

> - [UI] Show real dates in the Filters table @antcybersec (#23649)

### Broker 버전 및 서비스 설정을 구성할 수 있는 `meshery-broker` 차트

- 영향 대상: meshery-operator Helm 차트를 통해 Broker 버전 또는 서비스 필드를 구성하는 사용자

이전에는 차트에서 Broker 버전이나 서비스 노출 설정을 제공하지 않았습니다. 설정되지 않은 값은 생략되므로 기본 Broker 렌더링 결과는 바이트 단위로 그대로 유지됩니다.

> - [Helm] Give MeshSync read-only RBAC, expose Broker service values, clean up CRs on uninstall @yi-nuo426 (#23259)
> - [Helm] Give MeshSync read-only RBAC, expose Broker service values, clean up CRs on uninstall @yi-nuo426 (#23259)

## 기능·개선 (6)

- Local 프로바이더의 페이지네이션 없는 조직 목록 (사용 조건: `pagesize=all`을 지정한 조직 목록 요청)
- Chaos Mesh 실험의 비바인딩 레이블 매칭 관계
- Chaos Mesh 실험과 `Schedule` 간 관계 추가
- Chaos Mesh 실험의 원격 클러스터 참조 관계
- Meshery 전체 제거 명령
- 대시보드 선택기에 접근성 이름 추가

## 기타 (71)

- 콘텐츠 맵 없이 REST API 레이아웃에 표시되는 필수/선택 표시
- REST API 레퍼런스에서 누락된 요청 본문 `content` 맵을 빈 맵으로 렌더링
- 확장 기능 설치 및 제거 핸들러 테스트 확대
- 바인딩 관계 식별 속도 향상
- `EvaluateRelationshipPolicy` 테스트의 구조화된 응답 어설션
- 응답 JSON 구조와 envelope 내용까지 확인하는 `EvaluateRelationshipPolicy` 테스트
- 디코딩할 수 없는 provider 응답에 대한 필터 저장 처리 테스트
- 필터 저장 성공 시 정보성 이벤트 생성
- 사용자 키 조회에서 형식이 잘못된 조직 ID 거부
- 존재하지 않는 capability 삭제 시 `ErrResultNotFound` 반환
- Meshery 서버 HTTP 타임아웃 업데이트
- 환경 레코드 미존재 검사를 `isNotFoundError`로 통합
- Local 프로바이더 페이지네이션 오류의 HTTP 400 반환
- 어댑터 상태 로그의 불필요한 끝 줄바꿈 제거
- result-handler ID 엄격 검증
- `mesheryctl system context view` 컨텍스트 플래그 값 소문자 변환
- `mesheryctl perf result` 빈 결과 확인 수정
- 확장된 perf 결과의 표준 타임스탬프 형식
- Nil `Owner` 및 `MesheryID` UUID의 `None` 표시
- `TestResetCmd`에 시스템 플래그 정리 추가
- 플랫폼별 토큰 파일 순서 문서화
- `mesheryctl environment delete` 인자 검증 메시지 명확화
- Meshery 서버 및 `mesheryctl` 메시지 16개의 오탈자 수정
- `mesheryctl connection create`에서 예상치 못한 위치 인수 거부
- 설치 프로그램에서 플랫폼 프롬프트에 응답하는 경우의 BATS 테스트 추가
- mesheryctl 포트 포워딩 `errOut` 초기화 수정
- 인스톨러 ADAPTERS 테스트 계획에 BATS 테스트 추가
- provider-ui의 미사용 직접 의존성 제거
- 디자인 컨피규레이터 아코디언의 마운트 시 자동 스크롤 중단
- 커넥션 모달의 연결 정의 쿼리 훅 전환
- `NotificationProps.type` 허용 값 범위 축소: 'success' | 'error'
- MeshSync 알림 텍스트에 보조 테마 색상 적용
- MeshSync 알림 배경에 테마에 맞는 성공 및 오류 색상 적용
- MeshSync 재시도 버튼에 Sistent contained 오류 스타일 적용
- 레지스트리 헬퍼의 nullish 입력 가드 추가
- UI 감사 스크립트의 재귀적 파일 스캔 전환
- 성능 데이터 가져오기 오류 알림에 읽기 쉬운 메시지 표시
- Hex 색상 감사의 파일 시스템 오류 및 미완료 스캔 보고
- 색상 감지 시 주석을 건너뛰는 16진수 색상 검사
- 중첩된 프로덕션 디렉터리의 16진수 색상 검사
- 헥스 컬러 감사의 `rgb()` 및 `rgba()` 매칭 정확도 향상
- 헥스 색상 검사에서 테스트 파일과 중첩된 `__tests__` 디렉터리 제외
- 모델·종류·API 버전별 레지스트리 컴포넌트 상세 요청
- Kanvas 패턴 폼 입력란 확장 및 간격 축소
- MUI import 감사에서 TypeScript AST 파싱 사용
- 서버 단위 테스트 CI의 출력 스트리밍 및 아티팩트 업로드
- 설치 프로그램 플랫폼 프롬프트 테스트 추가
- 설치 프로그램 `ADAPTERS`용 BATS 테스트 추가
- 문서 미리보기 빌드에서 회의록 변경 사항 제외
- 기여 가이드에 사이드바 탐색 안내 반영
- 모든 상태에서 `TAP_ON_ERROR`를 처리하는 Kanvas Designer 검증기
- Meshery 데이터베이스 문서에서 Bitcask 제거
- 기여 안내 문서의 깨진 링크 수정
- 문서 브레드크럼 접근성 개선
- 문서 브레드크럼 접근성 개선
- 참조 문서 오타 수정
- 회의 문서에 Daniel Adeogun 커뮤니티 프로필 추가
- 문서 사이트 라이트박스 초기화 수정
- Docs 라이트박스 초기화 시 ReferenceError 수정
- Meshery provider 문서의 URL, 패키지 위치, 환경설정 경로 및 등록 예시 수정
- 잘못된 문서 링크 네 곳 수정
- Elisei Zaitsev 회의록을 `week-of-11-12-2026`로 이동
- 2026년 11월 12일 회의록에 Newcomer's Meet 제목 추가
- 작은 화면에서 `.content-table-wrapper` 숨김
- 페이지 메타데이터와 목차 링크에 `:focus-visible` 윤곽선 추가
- 코드 블록 래퍼가 `<div>`에서 `<span>`으로 변경
- 코드 블록 복사 버튼의 `:focus-visible` 윤곽선 표시
- 라이트 모드 페이지네이션 레이블 색상 수정
- 좁은 화면에서 한 열로 배치되는 Stacks 카드
- 페이지네이션 링크에 접근성 마크업 추가
- 페이지네이션 카드의 포커스 윤곽선 표시

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
