jetstream-api 0.22.1__tar.gz → 0.22.3__tar.gz

{jetstream_api-0.22.1 → jetstream_api-0.22.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.22.1
+Version: 0.22.3
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003
@@ -60,12 +60,29 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.22.3 변경 - 옛 클러스터 블롭 코덱 · actingCoordinator 제거, servicePorts (자바 v2.18.3 와 같음, 짝 엔진 7.0.1.3603 이상 권장)
+
+0.22.2 는 시험 판(test.pypi)만 내고 버렸다 - actingCoordinator 제거를 묶어 0.22.3 으로 나간다.
+
+- **없앰**(호환 깨짐): 옛 고정폭 클러스터 블롭 코덱 - ``ILClusterProperty(bytes)`` · ``ba=`` · ``get_serialized`` · ``get_serialized_length`` ·
+  ``LAYOUT_MARK``, ``ILClusterNode(bytes)`` · ``ba=`` · ``base=`` · ``get_serialized``, 모듈 ``CLUSTER_LAYOUT_MARK``,
+  ``ILC.MIMQ_VO_CLUSTER_LEN`` / ``MIMQ_VO_CLUSTER_NODE_LEN``. 바이트를 주면 ``TypeError``. 엔진 r3601 이 그 형식을 지웠고 0.22.0 부터
+  JSON(Property v2)으로만 주고받아 쓰는 경로가 없었다. 능력 선언 ``clsblob=2`` 는 그대로.
+- **없앰**(호환 깨짐): ``ILClusterProperty.actingCoordinator`` · ``get_acting_coordinator`` / ``getActingCoordinator`` - 0.18.1 부터 폐기 예정,
+  엔진 7.0.1.3484 부터 늘 ``None`` 이던 관측 칸이다(엔진 r3604 도 걷음). ``controllerLeader`` 를 읽는다 - 옛 이름으로 부르면 그렇게 안내한다.
+- **더함**: ``ILClusterProperty.servicePorts`` / ``getServicePorts()`` (읽기 전용) - 응답한 서비스가 맡은 컨트롤러(ilcc) 자리의 포트 전부
+  (엔진 ``PORT`` "a,b", 맡은 자리가 없으면 빈 목록). 컨트롤러가 멈춰 있어도 나온다 - 지금 듣는 포트는 ``localCtrlPort``.
+- 노드 ``status`` · ``nodeUuid`` · ``defTerm`` · ``defVersion`` 은 이름만 남는다(엔진 r3601 부터 와이어에 없어 늘 빈 값) - 문서를 고침.
+- 문서 정정: 팔로워 거절 ``MIMQE_OPERATION_DENIED (STANDBY)`` 는 **토픽**의 생성 · 변경 · 삭제만이다(쿼터 · 디스크 가드 · 클러스터에는 없다).
+- 엔진 r3603: 클러스터 서명(``signature``) 값의 재료가 정의의 공유 칸 전부로 넓어져 값이 바뀐다(키 · 형식 그대로, 클라 변경 없음).
+
 ## 0.22.1 변경 - 노드 추가 결과에 컨트롤러 기동 여부 (자바 v2.18.1 와 같음, started · wait 는 짝 엔진 7.0.1.3602 이상)
 
 - ``addNode`` 결과(``ILClusterNodeAddResult``)에 ``started`` · ``wait``(``is_started()``): 자리를 맡은 서비스가 컨트롤러를 **띄웠는가**와
   안 띄운 까닭(``MANUAL`` - 정의 STARTMODE 가 MANUAL 이라 :meth:`startCluster` 로 띄운다 · ``STOPPED`` - 사용자가 멈춰 둠 · ``FAILED`` -
   띄우다 실패, ilsvc 로그). 그 전 엔진은 이 칸을 주지 않아 맡았으면 띄운 것으로 본다(종전 동작).
-- 문서: 클러스터 팔로워 노드에 보낸 생성 · 변경 · 삭제는 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은 팔로워도 답한다.
+- 문서: **토픽**의 생성 · 변경 · 삭제를 클러스터 팔로워 노드에 보내면 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은
+  팔로워도 답한다. 쿼터 · 디스크 가드 · 클러스터(서비스가 받는 설정)에는 이 거절이 없다(배포 뒤 정정 - 처음에는 네 오브젝트 모두로 잘못 적었다).
 
 ## 0.22.0 변경 - 7 신규 오브젝트(쿼터 · 디스크 가드 · 토픽 · 클러스터) 관리를 Property v2(JSON)로 (자바 v2.18.0 와 같음, 짝 엔진 7.0.1.3601 이상)
 

{jetstream_api-0.22.1 → jetstream_api-0.22.3}/README.md

@@ -10,12 +10,29 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.22.3 변경 - 옛 클러스터 블롭 코덱 · actingCoordinator 제거, servicePorts (자바 v2.18.3 와 같음, 짝 엔진 7.0.1.3603 이상 권장)
+
+0.22.2 는 시험 판(test.pypi)만 내고 버렸다 - actingCoordinator 제거를 묶어 0.22.3 으로 나간다.
+
+- **없앰**(호환 깨짐): 옛 고정폭 클러스터 블롭 코덱 - ``ILClusterProperty(bytes)`` · ``ba=`` · ``get_serialized`` · ``get_serialized_length`` ·
+  ``LAYOUT_MARK``, ``ILClusterNode(bytes)`` · ``ba=`` · ``base=`` · ``get_serialized``, 모듈 ``CLUSTER_LAYOUT_MARK``,
+  ``ILC.MIMQ_VO_CLUSTER_LEN`` / ``MIMQ_VO_CLUSTER_NODE_LEN``. 바이트를 주면 ``TypeError``. 엔진 r3601 이 그 형식을 지웠고 0.22.0 부터
+  JSON(Property v2)으로만 주고받아 쓰는 경로가 없었다. 능력 선언 ``clsblob=2`` 는 그대로.
+- **없앰**(호환 깨짐): ``ILClusterProperty.actingCoordinator`` · ``get_acting_coordinator`` / ``getActingCoordinator`` - 0.18.1 부터 폐기 예정,
+  엔진 7.0.1.3484 부터 늘 ``None`` 이던 관측 칸이다(엔진 r3604 도 걷음). ``controllerLeader`` 를 읽는다 - 옛 이름으로 부르면 그렇게 안내한다.
+- **더함**: ``ILClusterProperty.servicePorts`` / ``getServicePorts()`` (읽기 전용) - 응답한 서비스가 맡은 컨트롤러(ilcc) 자리의 포트 전부
+  (엔진 ``PORT`` "a,b", 맡은 자리가 없으면 빈 목록). 컨트롤러가 멈춰 있어도 나온다 - 지금 듣는 포트는 ``localCtrlPort``.
+- 노드 ``status`` · ``nodeUuid`` · ``defTerm`` · ``defVersion`` 은 이름만 남는다(엔진 r3601 부터 와이어에 없어 늘 빈 값) - 문서를 고침.
+- 문서 정정: 팔로워 거절 ``MIMQE_OPERATION_DENIED (STANDBY)`` 는 **토픽**의 생성 · 변경 · 삭제만이다(쿼터 · 디스크 가드 · 클러스터에는 없다).
+- 엔진 r3603: 클러스터 서명(``signature``) 값의 재료가 정의의 공유 칸 전부로 넓어져 값이 바뀐다(키 · 형식 그대로, 클라 변경 없음).
+
 ## 0.22.1 변경 - 노드 추가 결과에 컨트롤러 기동 여부 (자바 v2.18.1 와 같음, started · wait 는 짝 엔진 7.0.1.3602 이상)
 
 - ``addNode`` 결과(``ILClusterNodeAddResult``)에 ``started`` · ``wait``(``is_started()``): 자리를 맡은 서비스가 컨트롤러를 **띄웠는가**와
   안 띄운 까닭(``MANUAL`` - 정의 STARTMODE 가 MANUAL 이라 :meth:`startCluster` 로 띄운다 · ``STOPPED`` - 사용자가 멈춰 둠 · ``FAILED`` -
   띄우다 실패, ilsvc 로그). 그 전 엔진은 이 칸을 주지 않아 맡았으면 띄운 것으로 본다(종전 동작).
-- 문서: 클러스터 팔로워 노드에 보낸 생성 · 변경 · 삭제는 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은 팔로워도 답한다.
+- 문서: **토픽**의 생성 · 변경 · 삭제를 클러스터 팔로워 노드에 보내면 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은
+  팔로워도 답한다. 쿼터 · 디스크 가드 · 클러스터(서비스가 받는 설정)에는 이 거절이 없다(배포 뒤 정정 - 처음에는 네 오브젝트 모두로 잘못 적었다).
 
 ## 0.22.0 변경 - 7 신규 오브젝트(쿼터 · 디스크 가드 · 토픽 · 클러스터) 관리를 Property v2(JSON)로 (자바 v2.18.0 와 같음, 짝 엔진 7.0.1.3601 이상)
 

{jetstream_api-0.22.1 → jetstream_api-0.22.3}/ilink/__init__.py

@@ -1,6 +1,6 @@
 """iLink - Python client API for iLink M.O.M. (Message Oriented Middleware)."""
 
-__version__ = "0.22.1"
+__version__ = "0.22.3"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser

{jetstream_api-0.22.1 → jetstream_api-0.22.3}/ilink/common.py

@@ -484,14 +484,8 @@ class ILC:
     # 노드(큐관리자)에게 묻는 런타임 관측 리포트 (OBS-1). TEXT | JSON
     MIMQ_GET_CLUSTER_RUNTIME = 3381
 
-    # 클러스터 속성 블롭 레이아웃 (C++ ClusterProperty.hpp 정본)
-    #   고정부(768) + 노드수(5) + 노드 x 384  - **가변 길이**라 고정폭 리스트 파서를 쓸 수 없다.
-    # 판 이력: 256 -> 512(CLSTOPO-1, 3-서비스 토폴로지) -> 768(컴트롤러 정족수).
-    #   ★ 768 판부터는 블롭 앞머리에 판 표시가 있다(:data:`ilink.properties.CLUSTER_LAYOUT_MARK`).
-    #   그 전 판은 표시가 없어 **레거시로 보고 거절**한다 - 길이로는 못 가른다
-    #   (512+5+256 과 768+5+0 이 둘 다 773 이다).
-    MIMQ_VO_CLUSTER_LEN = 768
-    MIMQ_VO_CLUSTER_NODE_LEN = 384
+    # 0.22.3: 클러스터 속성의 옛 고정폭 블롭(768 + 5 + 384 x N) 상수 MIMQ_VO_CLUSTER_LEN / MIMQ_VO_CLUSTER_NODE_LEN 을 없앴다 -
+    #   엔진 r3601 이 클러스터를 Property v2(JSON) 전용으로 바꾸며 그 형식을 지웠다.
     MIMQ_LIST_SIZE_LENGTH = 5
 
     # ------------------------------------------------------------------
@@ -983,8 +977,8 @@ class ILC:
     #: 능력 선언의 최대 길이(접두 포함). 넘으면 **자르지 않고 통째로 버린다** -
     #: 자르면 ``clsblob=2`` 가 ``clsblob=`` 가 되어 **읽히는데 뜻이 다른** 값이 된다.
     MIMQ_CLIENT_CAPS_MAX = 63
-    #: 이 클라가 읽고 쓰는 클러스터 블롭 판. :data:`ilink.properties.CLUSTER_LAYOUT_MARK`
-    #: 와 능력 선언이 **모두 이 값에서 나온다** - 판 번호를 두 곳에 적지 않는다.
+    #: 능력 선언(``CAP=clsblob=2``)의 클러스터 블롭 판. 0.22.3 부터 클라는 클러스터를 JSON 으로만 주고받지만(옛 블롭 코덱 제거)
+    #: 접속 능력 선언 토큰은 바꾸지 않는다 - 엔진이 핸드셰이크에서 읽는 값이다.
     MIMQ_CLUSTER_BLOB_VERSION = 2
     MIMQ_SESSION_STATUS_DEAD = 0
     MIMQ_SESSION_STATUS_IDLE = 1

{jetstream_api-0.22.1 → jetstream_api-0.22.3}/ilink/properties.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 import datetime
 import functools
 import re
-import warnings
 from enum import IntEnum
 from typing import List
 
@@ -4789,8 +4788,9 @@ class ILPropertyResult(_AutoAccessor):
     엔진이 무엇을 적용했고 무엇을 무시했는지 돌려준다 - 모르는 키를 무시하는 규칙(U4)이 **조용한 무시**가 되지 않게
     하는 장치다. 무시된 키가 있으면 라이브러리는 WARNING 로그도 남긴다(결과를 돌려주지 않는 옛 메서드도 같다).
 
-    클러스터의 팔로워 노드에 보낸 변경(CREATE / ALTER / DELETE)은 ``MIMQE_OPERATION_DENIED (STANDBY, leader=<리더>)`` 로
-    거절된다(연결 유형과 무관, 엔진 r3601). 조회(GET / LIST)는 팔로워도 답한다.
+    **토픽**의 생성 · 변경 · 삭제를 클러스터의 팔로워 노드(큐 관리자)에 보내면 ``MIMQE_OPERATION_DENIED (STANDBY, leader=<리더>)``
+    로 거절된다(연결 유형과 무관, 엔진 r3601) - 리더에 보낸다. 토픽 조회 · 목록은 팔로워도 답한다. 쿼터 · 디스크 가드 · 클러스터는
+    서비스(ilsvc)가 받는 설정이라 이 거절이 없다(쿼터는 서비스마다 따로 넣는다).
 
     Attributes:
         applied (list[tuple[str, str]]): 적용된 키와 반영 시점 ``(키, "NOW" | "RESTART")``.
@@ -5537,72 +5537,8 @@ class ILSpokeProperty(_AutoAccessor):
         )
 
 
-#: 클러스터 와이어 레이아웃 **판 표시**. 오프셋 0, 폭 4, 값 ``"V2"``.
-#:
-#: ★ **첫 글자가 숫자가 아니어야 한다.** 옛(레이아웃 1) 블롭은 오프셋 0 에 ``Status`` 를
-#: 왼쪽 정렬 십진수로 썼고 ``MIMQ_RUNNING`` 이 **2** 라, 판 표시를 ``"2"`` 로 두면
-#: 옛 블롭이 **"판 2 와 정확히 일치" 로 읽힌다**(거절도 아니고 "낮은 판" 도 아니다).
-#: 글자로 시작하면 옛 블롭이 만들 수 없는 값이 되어 두 방향이 모두 막힌다.
-CLUSTER_LAYOUT_MARK = "V%d" % ILC.MIMQ_CLUSTER_BLOB_VERSION
-
-#: :data:`CLUSTER_LAYOUT_MARK` 의 숫자 부분. 비교는 이쪽으로 한다 - 문자열 비교는
-#: ``"V10" < "V2"`` 로 갈린다.
-_CLUSTER_LAYOUT_NUMBER = ILC.MIMQ_CLUSTER_BLOB_VERSION
-
-#: :class:`ILClusterNode` 와이어 레이아웃 ``(속성 이름, 폭)``. **오프셋은 순서에서 계산한다** -
-#: 폭이 조정돼도 이 표 한 줄만 고치면 파싱·직렬화·보존이 같이 따라간다.
-#: 이름이 ``None`` 인 자리는 **클라가 읽지도 쓰지도 않는 구간**이다(원본을 그대로 되보낸다).
-_CLUSTER_NODE_FIELDS = (
-    ("nodeId", 5), ("qmgrName", 60), ("host", 128), ("port", 6),
-    ("ctrlPort", 6), ("status", 6), ("coord", 2), ("nodeUuid", 40),
-    ("defTerm", 10), ("defVersion", 10), (None, 111),
-)
-
-
-def _field_offsets(fields):
-    """``(이름, 폭)`` 표를 ``{이름: (오프셋, 폭)}`` 과 총길이로 편다.
-
-    Args:
-        fields: ``(이름, 폭)`` 튜플들. 이름이 None 이면 예약 구간이다.
-
-    Returns:
-        tuple: ``({이름: (오프셋, 폭)}, 총길이)``.
-    """
-    out, off = {}, 0
-    for name, width in fields:
-        if name is not None:
-            out[name] = (off, width)
-        off += width
-    return out, off
-
-
-_NODE_OFF, _NODE_LEN = _field_offsets(_CLUSTER_NODE_FIELDS)
-
-#: :class:`ILClusterNode` 에서 **클라가 값을 만들어 쓰는** 자리. 나머지 이름 있는 자리는
-#: 엔진이 채우는 값이라 **읽기만 하고 원본 바이트를 그대로 되돌려 보낸다.**
-#:
-#: ★ **읽기만 하는 자리를 다시 쓰지 않는 이유**: 다시 쓰면 **파싱 결함이 곧 쓰기 결함이
-#: 된다.** ``defTerm`` 을 잘못 읽으면 사람이 잘못 볼 뿐이지만, 잘못 읽은 값을 되쓰면
-#: 엔진 상태가 망가진다. 되보내지 않으면 그 경로 자체가 없다.
-_NODE_WRITTEN = ("nodeId", "qmgrName", "host", "port", "ctrlPort", "coord")
-
-
-def _pick_coord(ba, offset):
-    """``"C"`` / ``"-"`` / 빈칸을 ``True`` / ``False`` / ``None`` 으로 읽는다."""
-    text = ba_pick_string(ba, offset, 2).strip()
-    if text == "C":
-        return True
-    if text == "-":
-        return False
-    return None
-
-
 class ILClusterNode(_AutoAccessor):
-    """클러스터를 이루는 **노드 하나**. 고정폭 384 바이트 블롭.
-
-    레이아웃(판 ``V2``): NodeId(5) + QmgrName(60) + Host(128) + Port(6)
-    + CtrlPort(6) + Status(6) + Coord(2) + NodeUuid(40) + DefTerm(10) + DefVersion(10)
-    + Reserved(111)
+    """클러스터를 이루는 **노드 하나**. 와이어는 클러스터 정의 JSON 의 ``NODES`` 원소다(0.22.0 Property v2).
 
     노드는 **역할로 나뉜다 - 종류로 나뉘지 않는다.**
 
@@ -5639,25 +5575,17 @@ class ILClusterNode(_AutoAccessor):
             ☠ 다만 **동작에 쓰이는 것은 컨트롤러 정족수가 켜진 뒤**다 - 그전에는
             저장만 되고 아무 일도 일어나지 않는다.
             ☠ 문법의 ``COORDS(1)`` 은 *"1번이 컨트롤러고 **나머지는 아니다**"* 라는
-            완결된 진술이다. 블롭으로 같은 말을 하려면 나머지 노드를 **명시적으로
-            ``False``** 로 둬야 한다 - 빈칸으로 두면 *"모른다"* 가 되어 뜻이 다르다.
+            완결된 진술이다. 객체로 같은 말을 하려면 나머지 노드를 **명시적으로
+            ``False``** 로 둬야 한다 - ``None`` 으로 두면 *"모른다"* 가 되어 뜻이 다르다.
             컨트롤러 노드에는 **``ctrl_port`` 가 반드시** 있어야 한다.
             ★ **``None`` 은 "모름"** 이고 ``False``("아니다")와 **다르다**. 서버가 안
             채웠거나 이 판이 모르는 값일 때 ``None`` 이다. 참/거짓으로 판정하지 말고
             ``is None`` 으로 먼저 가른다.
-        status (int | None): **읽기 전용.** 서버가 채우는 이 노드의 상태.
-            ★ **``None`` 은 "모름"** 이다 - 엔진이 아직 이 노드를 못 봤으면 빈칸으로 온다.
-            ``0`` 으로 읽지 않는다: 상태 코드에 0 이 없어(STOPPED 1 / RUNNING 2 /
-            STARTING 4) **0 을 주면 있지도 않은 상태를 지어내는 것**이 된다.
-            ※ :attr:`ILClusterProperty.status` 는 정의의 실행 상태라 엔진이 늘 채운다 -
-            거기는 ``int`` 그대로다. **두 status 는 뜻이 다르다.**
-        nodeUuid (str): **읽기 전용.** 노드가 **첫 합류 때 스스로 찍는 신원**.
-            같은 번호에 다른 장비를 넣으면 엔진이 이 값으로 잡아낸다 - 그래서 클라는
-            **읽기만 하고 받은 값을 그대로 되돌려 보낸다.**
-        defTerm (int | None): **읽기 전용.** 이 노드가 든 정의의 **임기**.
-        defVersion (int | None): **읽기 전용.** 이 노드가 든 정의의 **판 번호**.
-            ★ ``defTerm`` 과 **쌍**이다 - 한쪽만 값이면 프로토콜 오류다.
-            ★ **0 은 정상값**이다(선출이 한 번도 없었던 새 클러스터). 없음은 오직 ``None``.
+        status (int | None): **읽기 전용.** 엔진 r3601(Property v2)부터 와이어에 없다 - 늘 ``None``.
+        nodeUuid (str): **읽기 전용.** 엔진 r3601 부터 와이어에 없다 - 늘 ``""``.
+        defTerm (int | None): **읽기 전용.** 엔진 r3601 부터 와이어에 없다 - 늘 ``None``. 정의의 판은
+            :attr:`ILClusterProperty.defTerm` / :attr:`ILClusterProperty.defVersion` 으로 본다.
+        defVersion (int | None): **읽기 전용.** 위와 같다 - 늘 ``None``.
 
     Example::
 
@@ -5677,25 +5605,24 @@ class ILClusterNode(_AutoAccessor):
         "ilccPort": ("ctrlPort", "0.17.0"),
     }
 
-    def __init__(self, qmgr_name: str | bytes | bytearray | None = None, host: str = "",
-                 port: int = 0, ctrl_port: int = 0, node_id: int = 0,
-                 ba: bytes | bytearray | None = None, base: int = 0) -> None:
-        """노드를 만든다. ``bytes`` 를 주면 서버 응답으로 보고 파싱한다.
+    def __init__(self, qmgr_name: str | None = None, host: str = "",
+                 port: int = 0, ctrl_port: int = 0, node_id: int = 0) -> None:
+        """노드를 만든다.
 
         Args:
-            qmgr_name (str | bytes | bytearray | None): 큐 관리자 이름. 비우면 컨트롤러
-                전용 노드다. ``bytes`` 를 주면 서버 응답으로 보고 파싱한다(다른 속성
-                클래스와 같은 관례).
+            qmgr_name (str | None): 큐 관리자 이름. 비우면 컨트롤러 전용 노드다.
             host (str): 호스트(IP 또는 이름).
             port (int): 데이터 포트. 컨트롤러 전용 노드는 0.
             ctrl_port (int): 컨트롤러 포트(문법에서 주소 뒤 ``/9000`` 자리).
             node_id (int): 노드 번호(``NODE[n]`` 인덱스).
-            ba (bytes | bytearray | None): 서버가 보낸 고정폭 바이트.
-            base (int): ``ba`` 안에서 이 노드가 시작하는 위치.
 
-        Raises:
-            ILDeserializeException: 바이트가 384 바이트보다 짧을 때.
+        Note:
+            0.22.3 에서 옛 고정폭 블롭 생성(``ILClusterNode(bytes)`` · ``ba=`` · ``base=``)과 ``get_serialized`` 를 없앴다 -
+            엔진 r3601 이 그 형식을 지웠고 0.22.0 부터 클라도 JSON 으로만 주고받는다.
         """
+        if isinstance(qmgr_name, (bytes, bytearray)):
+            # 0.22.3: 옛 고정폭 블롭 생성자는 없앴다 - 바이트를 이름으로 조용히 받지 않는다
+            raise TypeError("ILClusterNode(bytes) was removed in 0.22.3 - the engine speaks JSON (Property v2) only")
         self.nodeId = node_id
         self.qmgrName = ""
         self.host = host
@@ -5706,69 +5633,8 @@ class ILClusterNode(_AutoAccessor):
         self.nodeUuid = ""
         self.defTerm = None
         self.defVersion = None
-        #: (내부) 서버가 준 원본 384바이트. **읽기만 하는 자리와 읽지도 쓰지도 않는
-        #: 구간을 되돌려 보내기 위해** 들고 있다(:meth:`get_serialized` 참조).
-        #: 직접 만든 객체는 빈 값.
-        self._rawBytes = b""
-
-        if isinstance(qmgr_name, (bytes, bytearray)) and ba is None:
-            ba, qmgr_name = bytes(qmgr_name), None
         if qmgr_name is not None:
             self.qmgrName = qmgr_name
-        if ba is None:
-            return
-        if len(ba) - base < _NODE_LEN:
-            raise ILDeserializeException(
-                "invalid byte array length. fixed : [" + str(_NODE_LEN)
-                + "] / actual : [" + str(len(ba) - base) + "]")
-        o = _NODE_OFF
-        self.nodeId = ba_pick_int(ba, base + o["nodeId"][0], o["nodeId"][1])
-        self.qmgrName = ba_pick_string(ba, base + o["qmgrName"][0], o["qmgrName"][1])
-        self.host = ba_pick_string(ba, base + o["host"][0], o["host"][1])
-        self.port = ba_pick_int(ba, base + o["port"][0], o["port"][1])
-        self.ctrlPort = ba_pick_int(ba, base + o["ctrlPort"][0], o["ctrlPort"][1])
-        self.status = ba_pick_int_opt(ba, base + o["status"][0], o["status"][1])
-        self.coordinator = _pick_coord(ba, base + o["coord"][0])
-        self.nodeUuid = ba_pick_string(ba, base + o["nodeUuid"][0], o["nodeUuid"][1])
-        self.defTerm = ba_pick_int_opt(ba, base + o["defTerm"][0], o["defTerm"][1])
-        self.defVersion = ba_pick_int_opt(ba, base + o["defVersion"][0], o["defVersion"][1])
-        self._rawBytes = bytes(ba[base:base + _NODE_LEN])
-
-    def get_serialized(self) -> bytes:
-        """이 객체를 서버 규격의 **고정폭 384 바이트**로 직렬화한다.
-
-        Returns:
-            bytes: 서버로 그대로 보낼 수 있는 바이트열.
-
-        Note:
-            ★ **클라가 값을 만들어 쓰는 자리만 다시 쓴다**(:data:`_NODE_WRITTEN`).
-            읽기만 하는 자리(``status`` · ``nodeUuid`` · ``defTerm`` · ``defVersion``)와
-            읽지도 쓰지도 않는 구간은 **원본을 그대로 되돌려 보낸다.** 서버가 준
-            바이트로 만든 객체일 때만 그렇다. 0 으로 채운 버퍼에 아는 자리만 쓰면 그
-            구간이 **0x00 으로 지워져 돌아간다** - 지우면 예외 없이 뜻이 바뀐다.
-
-            ★ **미설정은 빈칸으로 쓴다. 0 을 쓰지 않는다.** ``coordinator`` 가 그렇다 -
-            규격이 **"0 은 정상값이고 없음은 오직 빈칸"** 으로 정했다.
-
-            문자열은 **폭 − 1** 까지만 쓴다. 엔진이 C 문자열로 읽으므로 폭을 꽉 채우면
-            끝을 못 찾고 다음 필드까지 읽는다.
-        """
-        o = _NODE_OFF
-        if len(self._rawBytes) == _NODE_LEN:
-            ba = bytearray(self._rawBytes)
-            for name in _NODE_WRITTEN:                  # 내가 쓰는 자리만 비우고 다시 쓴다
-                off, width = o[name]
-                ba[off:off + width] = bytes(width)
-        else:
-            ba = bytearray(_NODE_LEN)
-        ba_merge(self.nodeId, ba, o["nodeId"][0], o["nodeId"][1])
-        ba_merge(self.qmgrName, ba, o["qmgrName"][0], o["qmgrName"][1] - 1)
-        ba_merge(self.host, ba, o["host"][0], o["host"][1] - 1)
-        ba_merge(self.port, ba, o["port"][0], o["port"][1])
-        ba_merge(self.ctrlPort, ba, o["ctrlPort"][0], o["ctrlPort"][1])
-        if self.coordinator is not None:            # None 은 빈칸(모름)으로 남긴다
-            ba_merge("C" if self.coordinator else "-", ba, o["coord"][0], o["coord"][1])
-        return bytes(ba)
 
     def get_address(self) -> str:
         """큐 관리자 주소 ``"host:port"``(데이터 포트).
@@ -5797,8 +5663,8 @@ class ILClusterNode(_AutoAccessor):
         Note:
             ★ :class:`_AutoAccessor` 가 자동으로 만드는 ``isX()`` 는 ``bool(값)`` 이라
             ``None`` 을 ``False``("아니다")로 바꾼다. 그래서 이 메서드를 손으로 둔다 -
-            **"모름" 을 "아니다" 로 바꾸지 않는다.** 엔진이 ``"C"`` / ``"-"`` / 빈칸
-            세 값으로 인코딩한 뜻이 편의 계층에서 사라지면 안 된다.
+            **"모름" 을 "아니다" 로 바꾸지 않는다.** 엔진이 ``COORD`` true / false / 키 없음
+            세 상태로 주는 뜻이 편의 계층에서 사라지면 안 된다.
         """
         return self.coordinator
 
@@ -6359,48 +6225,6 @@ class ILClusterControlResult(_AutoAccessor):
             s += " [" + ", ".join(self.skippedNodes) + "]"
         return s
 
-#: :class:`ILClusterProperty` 고정부 와이어 레이아웃 ``(속성 이름, 폭)``.
-#: :data:`_CLUSTER_NODE_FIELDS` 와 같은 규칙 - **오프셋은 순서에서 계산한다.**
-#: 이름이 ``None`` 인 자리는 클라가 읽지도 쓰지도 않는 구간이다.
-_CLUSTER_FIXED_FIELDS = (
-    ("layoutVersion", 4), ("clusterId", 40), ("name", 60), ("status", 6),
-    ("startMode", 20),
-    ("controllerHeartbeatIntervalMs", 10), ("controllerElectionTimeoutMs", 10),
-    ("heartbeatIntervalMs", 10), ("heartbeatMissCount", 5), ("electionDelayMs", 10),
-    ("replicas", 5), ("minSync", 5),
-    ("secretFile", 256),
-    ("controllerLeader", 6), ("defTerm", 10), ("defVersion", 10),
-    ("signature", 20), ("statusReason", 96),
-    # 엔진 r3473 이 예약 앞 12바이트에 이름을 줬다. **판 번호는 안 올랐다**(V2 그대로) -
-    # 이 클라는 모르는 자리를 원본째 되보내므로 이름이 붙기 전에도 아무 문제가 없었다.
-    # ☠ 둘 다 **관측 전용**이다: 엔진이 나갈 때만 채우고 들어올 때는 지운다.
-    # actingCoordinator 는 **폐기 예정**이다(0.18.1): r3481~r3483 은 controllerLeader 의 사본이었고,
-    # r3484 부터는 엔진이 채우지 않는다. 이 12바이트 중 앞 6바이트(583..588)는 **영구 결번** -
-    # 다른 값에 다시 쓰이지 않는다(옛 클라가 새 값을 이 이름으로 조용히 잘못 읽지 않도록).
-    ("actingCoordinator", 6), ("localCtrlPort", 6),
-    # 엔진 PLACEMENT-1: 예약 앞 20바이트에 **정의 칸 둘**. 판 표시는 V2 그대로 - 옛 블롭에는 0x00 이라
-    # 미설정으로 읽힌다. 빈칸으로 보내면 엔진이 저장값을 유지하고, "DEFAULT" 를 보내면 미설정으로 되돌린다.
-    ("placement", 12), ("autoRebalance", 8), (None, 153),
-)
-
-_CLUSTER_OFF, _CLUSTER_LEN = _field_offsets(_CLUSTER_FIXED_FIELDS)
-
-#: :class:`ILClusterProperty` 에서 **클라가 값을 만들어 쓰는** 자리. 나머지 이름 있는
-#: 자리는 엔진이 채우므로 **읽기만 하고 원본 바이트를 그대로 되돌려 보낸다**
-#: (:data:`_NODE_WRITTEN` 와 같은 규칙과 같은 이유).
-_CLUSTER_WRITTEN = ("layoutVersion", "name", "startMode",
-                    "controllerHeartbeatIntervalMs", "controllerElectionTimeoutMs",
-                    "heartbeatIntervalMs", "heartbeatMissCount", "electionDelayMs",
-                    "replicas", "minSync", "placement", "autoRebalance")
-
-# 표에서 계산한 길이와 공개 상수가 어긋나면 **여기서 터진다.** 한쪽만 고치는 일을 막는다 -
-# 상수를 써서 오프셋을 잡는 코드가 밖에 있어서 조용히 어긋나면 잘못된 자리를 파게 된다.
-if (_NODE_LEN, _CLUSTER_LEN) != (ILC.MIMQ_VO_CLUSTER_NODE_LEN, ILC.MIMQ_VO_CLUSTER_LEN):
-    raise RuntimeError(
-        "cluster layout tables and ILC constants disagree : node %d vs %d, fixed %d vs %d"
-        % (_NODE_LEN, ILC.MIMQ_VO_CLUSTER_NODE_LEN, _CLUSTER_LEN, ILC.MIMQ_VO_CLUSTER_LEN))
-
-
 class ILFollowerStatus(_AutoAccessor):
     """리더가 본 **팔로워 하나**의 복제 상태. :class:`ILReplicationStatus` 의 :attr:`~ILReplicationStatus.followers` 항목이다.
 
@@ -6755,50 +6579,8 @@ class ILGroupDescription(ILGroupInfo):
     getOffset = get_offset
 
 
-def _cluster_layout_number(ba, offset: int = 0) -> int:
-    """블롭 앞머리의 **판 표시**를 읽어 판 번호를 돌려준다.
-
-    Args:
-        ba (bytes | bytearray): 고정부를 담은 바이트.
-        offset (int): 고정부가 시작하는 위치.
-
-    Returns:
-        int: 판 번호. ``"V2"`` 면 2.
-
-    Raises:
-        ILDeserializeException: 판 표시가 없거나(레거시) 형식이 틀렸을 때.
-
-    Note:
-        ★ **판 표시가 숫자면 안 된다.** 옛 레이아웃은 오프셋 0 에 ``Status`` 를 십진수로
-        썼고 ``MIMQ_RUNNING`` 이 **2** 라, 표시를 ``"2"`` 로 뒀으면 옛 블롭이
-        **"판 2 와 정확히 일치"** 로 읽혔다 - 거절도 아니고 "낮은 판" 도 아니다.
-        길이로도 못 가른다(옛 512+5+256 과 새 768+5+0 이 둘 다 773 이다).
-        ``"V"`` 로 시작하면 옛 블롭이 **만들 수 없는 값**이 되어 두 방향이 다 막힌다.
-
-        ★ **마커가 없는 것은 레거시이고 무조건 거절한다.** "낮으면 미설정으로 읽는다"
-        는 **마커가 있는 판들 사이에서만** 쓰는 규칙이다 - 1→2 는 덧붙임이 아니라
-        재배치라서(``Status`` 가 오프셋 0 에서 104 로 갔다) 이어 읽을 수가 없다.
-    """
-    off, width = _CLUSTER_OFF["layoutVersion"]
-    mark = ba_pick_string(ba, offset + off, width).strip()
-    if not mark or not mark.startswith("V") or not mark[1:].isdigit():
-        raise ILDeserializeException(
-            "unsupported cluster layout : this engine speaks the v2 cluster layout"
-            " (marker %r at offset 0) but the blob has no marker - it is the legacy"
-            " layout and cannot be read" % (mark,))
-    return int(mark[1:])
-
-
 class ILClusterProperty(_AutoAccessor):
-    """클러스터 정의 1개. 가변 길이 블롭.
-
-    직렬화 = 고정부(768) + 노드수(5) + 노드 x 384
-
-    고정부 레이아웃(판 ``V2``): LayoutVersion(4) + ClusterId(40) + Name(60) + Status(6)
-    + StartMode(20) + CtrlHbIntervalMs(10) + CtrlElectTimeoutMs(10) + HbIntervalMs(10)
-    + HbMissCount(5) + ElectionDelayMs(10) + Replicas(5) + MinSync(5) + SecretFile(256)
-    + ControllerLeader(6) + DefTerm(10) + DefVersion(10) + Signature(20)
-    + StatusReason(96) + ActingCoordinator(6) + LocalCtrlPort(6) + Reserved(173)
+    """클러스터 정의 1개. 와이어는 Property v2 JSON(``_TYPE`` = ``CLUSTER``, 0.22.0)이다.
 
     **정의는 하나다.** 예전에는 클러스터 하나를 관리 서비스 셋(판사·MAIN·SUB)에 각자의
     정의로 만들었는데, 이제 **노드 목록 하나**에 전 노드를 적고 그중 컨트롤러를 맡을
@@ -6856,12 +6638,9 @@ class ILClusterProperty(_AutoAccessor):
             ★ ``defTerm`` 과 **쌍**이다. **0 은 정상값**이고 없음은 오직 ``None`` 이다.
             이 판은 **응답한 서비스가 저장한 사본의 판**이다. 그래서 서비스마다 다를 수 있고, 뒤처진 사본은 판이 낮다.
         signature (str): **읽기 전용.** 엔진이 정의에 붙이는 표식.
-        actingCoordinator (int | None): **읽기 전용.** 승격을 집행하는 조정자의
-            노드 번호. 모르면 ``None`` - **0 은 노드 번호가 아니다.**
-            ☠ **폐기 예정(0.18.1).** 엔진 r3481~r3483 은 :attr:`controllerLeader` 의 **사본**이었고
-            (승격을 집행하는 자가 곧 컨트롤러 리더다), r3484 부터는 엔진이 채우지 않아 늘
-            ``None`` 이고, 이 자리는 다른 값에 다시 쓰이지 않는다. :attr:`controllerLeader` 를
-            읽어라. 접근자 :meth:`get_acting_coordinator` 는 부를 때마다 경고를 낸다.
+        servicePorts (list[int]): **읽기 전용.** 이 응답을 준 **서비스가 맡은** 컨트롤러(ilcc) 자리의 포트 전부
+            (0.22.3, 엔진 r3601 의 ``PORT``). 설정값이라 컨트롤러가 멈춰 있어도 나온다. 맡은 자리가 없으면 빈 목록.
+            :attr:`localCtrlPort` 는 그중 **지금 실제로 듣는** 포트 하나(관측값)다.
         localCtrlPort (int | None): **읽기 전용.** 이 응답을 준 **서비스가 실제로
             듣고 있는** ilcc 포트. 정의에 적힌 값이 아니라 **관측값**이다.
             ★ 둘 다 엔진이 **나갈 때만** 채운다 - 실어 보내도 무시된다.
@@ -6888,10 +6667,6 @@ class ILClusterProperty(_AutoAccessor):
         svc.createCluster(c)
     """
 
-    #: 이 클래스가 읽고 쓰는 와이어 레이아웃의 **판 표시**. 자바 ``ILClusterProperty.LAYOUT_MARK``
-    #: 와 **같은 자리에 같은 이름**으로 둔다 - 모듈 수준 :data:`CLUSTER_LAYOUT_MARK` 와 같은 값이다.
-    LAYOUT_MARK = CLUSTER_LAYOUT_MARK
-
     # 엔진 ClusterProperty::Validate() 와 같은 규칙.
     _SPEC = {
         "name": _spec_maxlen(47),
@@ -6906,8 +6681,8 @@ class ILClusterProperty(_AutoAccessor):
         "defTerm": "엔진이 채우는 값이다",
         "defVersion": "엔진이 채우는 값이다",
         "signature": "엔진이 채우는 값이다",
-        "actingCoordinator": "관측값이다 - 엔진이 나갈 때만 채운다",
         "localCtrlPort": "관측값이다 - 답한 서비스가 실제로 듣는 포트다",
+        "servicePorts": "답한 서비스가 맡은 자리라 엔진이 채운다",
     }
 
     _RENAMED = {
@@ -6915,24 +6690,22 @@ class ILClusterProperty(_AutoAccessor):
         "ilccPort": ("노드마다의 ILClusterNode.ctrlPort", "0.17.0"),
         "judge": ("노드마다의 ILClusterNode.is_coordinator", "0.17.0"),
         "coordinator": ("노드마다의 ILClusterNode.is_coordinator", "0.17.0"),
+        # 0.22.3: 엔진 r3484 부터 늘 None 이던 관측 칸을 걷었다(엔진 r3604 도 걷음) - 승격을 집행하는 자는 컨트롤러 리더다
+        "actingCoordinator": ("controllerLeader", "0.22.3"),
         "authorityHolder": ("controllerLeader (노드 번호다)", "0.17.0"),
     }
 
-    def __init__(self, name: str | bytes | bytearray | None = None, *,
-                 is_auto_start: bool = True,
-                 ba: bytes | bytearray | None = None) -> None:
+    def __init__(self, name: str | None = None, *, is_auto_start: bool = True) -> None:
         """클러스터 정의를 만든다.
 
         Args:
-            name (str | bytes | bytearray | None): 클러스터 이름. ``bytes`` 를 주면 서버
-                응답으로 보고 파싱한다(:class:`ILQueueProperty` 와 같은 관례).
+            name (str | None): 클러스터 이름.
             is_auto_start (bool): 서비스가 뜰 때 같이 띄울지. 기본 True.
-            ba (bytes | bytearray | None): 서버가 보낸 바이트(키워드로도 줄 수 있다).
-                주면 나머지 인자는 무시된다.
 
-        Raises:
-            ILDeserializeException: 바이트 길이가 규격보다 짧거나, **판 표시가 없거나
-                (레거시) 이 클라보다 높을 때.**
+        Note:
+            0.22.3 에서 옛 고정폭 블롭 생성(``ILClusterProperty(bytes)`` · ``ba=``)과 ``get_serialized`` ·
+            ``get_serialized_length`` · ``LAYOUT_MARK`` 를 없앴다 - 엔진 r3601 이 그 형식을 지웠고 0.22.0 부터 클라도 JSON 으로만
+            주고받는다(:meth:`ILAdminService.getClusterProperty` 가 채운다).
 
         Note:
             ★ **둘째 자리부터는 키워드로만 받는다.** 예전 둘째 자리는 ``ilcc_port`` 였다.
@@ -6941,7 +6714,8 @@ class ILClusterProperty(_AutoAccessor):
             나쁘다.** 키워드 전용으로 막아 ``TypeError`` 로 터지게 한다.
         """
         if isinstance(name, (bytes, bytearray)):
-            ba, name = name, ""
+            # 0.22.3: 옛 고정폭 블롭 생성자는 없앴다 - 바이트를 이름으로 조용히 받지 않는다
+            raise TypeError("ILClusterProperty(bytes) was removed in 0.22.3 - the engine speaks JSON (Property v2) only")
         self.name = name or ""
         self.autoStart = is_auto_start
         self.heartbeatIntervalMs = 1000
@@ -6961,76 +6735,10 @@ class ILClusterProperty(_AutoAccessor):
         self.defTerm = None
         self.defVersion = None
         self.signature = ""
-        self.actingCoordinator = None
         self.localCtrlPort = None
-        #: (내부) 서버가 준 고정부 원본. **읽기만 하는 자리와 읽지도 쓰지도 않는 구간을
-        #: 되돌려 보내기 위해** 들고 있다(:meth:`get_serialized` 참조).
-        self._rawBytes = b""
+        self.servicePorts: list = []
         self.nodes: list[ILClusterNode] = []
 
-        if ba is None:
-            return
-        if len(ba) < _CLUSTER_LEN + ILC.MIMQ_LIST_SIZE_LENGTH:
-            raise ILDeserializeException(
-                "invalid byte array length. minimum : ["
-                + str(_CLUSTER_LEN + ILC.MIMQ_LIST_SIZE_LENGTH)
-                + "] / actual : [" + str(len(ba)) + "]")
-
-        ver = _cluster_layout_number(ba)
-        if ver > _CLUSTER_LAYOUT_NUMBER:
-            raise ILDeserializeException(
-                "unsupported cluster layout : the server speaks %r but this client"
-                " knows %r - upgrade the client. nothing was parsed."
-                % ("V" + str(ver), CLUSTER_LAYOUT_MARK))
-        if ver < _CLUSTER_LAYOUT_NUMBER:
-            # 규칙은 "낮으면 없던 필드는 미설정" 인데, V2 가 **마커가 있는 첫 판**이라
-            # 이 가지는 도달할 수 없다. 도달했다면 블롭이 손상된 것이지 옛 판이 아니다.
-            raise ILDeserializeException(
-                "unsupported cluster layout : %r is below %r, and %r is the first"
-                " layout that carries a marker at all - the blob is damaged"
-                % ("V" + str(ver), CLUSTER_LAYOUT_MARK, CLUSTER_LAYOUT_MARK))
-
-        o = _CLUSTER_OFF
-        self.clusterId = ba_pick_string(ba, o["clusterId"][0], o["clusterId"][1])
-        self.name = ba_pick_string(ba, o["name"][0], o["name"][1])
-        self.status = ba_pick_int(ba, o["status"][0], o["status"][1])
-        # 정확히 "AUTO" 만 자동이다(엔진 규칙). 그 밖은 전부 MANUAL.
-        self.autoStart = ba_pick_string(ba, o["startMode"][0], o["startMode"][1]).strip() == "AUTO"
-        self.controllerHeartbeatIntervalMs = ba_pick_int_opt(
-            ba, o["controllerHeartbeatIntervalMs"][0], o["controllerHeartbeatIntervalMs"][1])
-        self.controllerElectionTimeoutMs = ba_pick_int_opt(
-            ba, o["controllerElectionTimeoutMs"][0], o["controllerElectionTimeoutMs"][1])
-        self.heartbeatIntervalMs = ba_pick_int(ba, o["heartbeatIntervalMs"][0],
-                                               o["heartbeatIntervalMs"][1])
-        self.heartbeatMissCount = ba_pick_int(ba, o["heartbeatMissCount"][0],
-                                              o["heartbeatMissCount"][1])
-        self.electionDelayMs = ba_pick_int(ba, o["electionDelayMs"][0], o["electionDelayMs"][1])
-        self.replicas = ba_pick_int_opt(ba, o["replicas"][0], o["replicas"][1])
-        self.minSync = ba_pick_int_opt(ba, o["minSync"][0], o["minSync"][1])
-        self.placement = ba_pick_string(ba, o["placement"][0], o["placement"][1]).strip() or None
-        self.autoRebalance = ba_pick_string(ba, o["autoRebalance"][0], o["autoRebalance"][1]).strip() or None
-        self.secretFile = ba_pick_string(ba, o["secretFile"][0], o["secretFile"][1])
-        self.controllerLeader = ba_pick_int_opt(ba, o["controllerLeader"][0],
-                                                o["controllerLeader"][1])
-        self.defTerm = ba_pick_int_opt(ba, o["defTerm"][0], o["defTerm"][1])
-        self.defVersion = ba_pick_int_opt(ba, o["defVersion"][0], o["defVersion"][1])
-        self.signature = ba_pick_string(ba, o["signature"][0], o["signature"][1])
-        self.actingCoordinator = ba_pick_int_opt(ba, o["actingCoordinator"][0],
-                                                o["actingCoordinator"][1])
-        self.localCtrlPort = ba_pick_int_opt(ba, o["localCtrlPort"][0],
-                                            o["localCtrlPort"][1])
-        _sr_off, _sr_len = o["statusReason"]
-        self.statusReason = bytes(ba[_sr_off:_sr_off + _sr_len]).split(b"\x00")[0].decode(
-            "utf-8", "replace")
-        self._rawBytes = bytes(ba[:_CLUSTER_LEN])
-
-        offset = _CLUSTER_LEN
-        count = ba_pick_int(ba, offset, ILC.MIMQ_LIST_SIZE_LENGTH)
-        offset += ILC.MIMQ_LIST_SIZE_LENGTH
-        for _ in range(count):
-            self.nodes.append(ILClusterNode(ba=ba, base=offset))
-            offset += _NODE_LEN
-
     # ── 조회 ────────────────────────────────────────────────────────────
     # ── Property v2(JSON, 엔진 설계 §13-4) ──────────────────────────────────────
     #: 0.22.0: ALTER 로 보낼 수 있는 칸(세터 · 필드 대입으로 바꾼 것만 간다). 종류는 아래 _pv2_* 가 직접 다룬다
@@ -7080,7 +6788,13 @@ class ILClusterProperty(_AutoAccessor):
         object.__setattr__(self, "signature", t(obj, "SIGNATURE", "STR") or "")
         object.__setattr__(self, "controllerLeader", t(obj, "CONTROLLERLEADER", "INT"))
         object.__setattr__(self, "localCtrlPort", t(obj, "LOCALCTRLPORT", "INT"))
-        object.__setattr__(self, "actingCoordinator", None)
+        # 0.22.3: PORT = 이 서비스가 맡은 ilcc 자리 포트 "a,b"(맡은 자리가 없으면 "0")
+        ports = []
+        for x in (t(obj, "PORT", "STR") or "").split(","):
+            x = x.strip()
+            if x.isdigit() and int(x) > 0:
+                ports.append(int(x))
+        object.__setattr__(self, "servicePorts", ports)
         nodes = []
         for e in obj.get("NODES", []) or []:
             if not isinstance(e, dict):
@@ -7174,26 +6888,6 @@ class ILClusterProperty(_AutoAccessor):
 
     getBrokerNodes = get_broker_nodes
 
-    def get_acting_coordinator(self):
-        """**폐기 예정(0.18.1).** 승격을 집행하는 조정자의 노드 번호(:attr:`actingCoordinator`).
-
-        엔진 r3481~r3483 은 이 값이 :attr:`controllerLeader` 의 **사본**이었다 - 승격을 집행하는 자가
-        곧 컨트롤러 리더다. r3484 부터는 엔진이 이 칸을 채우지 않아 늘 ``None`` 이고, 그 자리는
-        다른 값에 다시 쓰이지 않는다.
-
-        Returns:
-            int | None: 노드 번호. 모르면 ``None``.
-
-        Warns:
-            DeprecationWarning: 부를 때마다. :attr:`controllerLeader` 를 읽어라.
-        """
-        warnings.warn("ILClusterProperty.getActingCoordinator() is deprecated - read controllerLeader"
-                      " (always None from engine r3484)",
-                      DeprecationWarning, stacklevel=2)
-        return self.actingCoordinator
-
-    getActingCoordinator = get_acting_coordinator
-
     def _validate_addresses(self) -> None:
         """노드 주소가 서로 겹치는지 **모든 짝**을 본다.
 
@@ -7283,74 +6977,6 @@ class ILClusterProperty(_AutoAccessor):
             return ILC.MIMQ_STARTING_STR
         return str(self.status)
 
-    # ── 직렬화 ──────────────────────────────────────────────────────────
-    def get_serialized_length(self) -> int:
-        """직렬화했을 때의 바이트 길이.
-
-        Returns:
-            int: ``768 + 5 + 384 x 노드수``. 엔진은 길이를 따로 검사하지 않으므로
-            정확해야 한다.
-        """
-        return _CLUSTER_LEN + ILC.MIMQ_LIST_SIZE_LENGTH + len(self.nodes) * _NODE_LEN
-
-    def get_serialized(self) -> bytes:
-        """이 객체를 서버 규격의 바이트로 직렬화한다.
-
-        Returns:
-            bytes: 서버로 그대로 보낼 수 있는 바이트열.
-
-        Note:
-            ★ **클라가 값을 만들어 쓰는 자리만 다시 쓴다**(:data:`_CLUSTER_WRITTEN`).
-            ``clusterId`` · ``secretFile`` · ``signature`` · ``controllerLeader`` ·
-            ``(defTerm, defVersion)`` 은 **읽기만 하고 받은 바이트를 그대로 되보낸다** -
-            0 으로 지워 보내면 엔진이 신원과 판 번호를 잃는다.
-
-            ★ **미설정은 빈칸으로 쓴다. 0 을 쓰지 않는다.** ``replicas`` / ``minSync``
-            가 그렇다 - **"말하지 않았다" 를 "3 이라고 말했다" 로 바꾸면** 노드를 더할 때
-            거절당한다(엔진이 명시된 RF 와 노드 수가 어긋난다고 본다).
-
-            ★ 늘 적용되는 값은 **빠짐없이** 싣는다 - 자동 기동(비우면 MANUAL 로
-            저장된다)과 노드 감시 하트비트 셋(0 을 보내면 100/1/0 으로 바뀐다).
-        """
-        ba = bytearray(self.get_serialized_length())
-        o = _CLUSTER_OFF
-        if len(self._rawBytes) == _CLUSTER_LEN:
-            # 읽기만 하는 자리와 모르는 자리를 원본 그대로 되보낸다(노드와 같은 규칙).
-            ba[:_CLUSTER_LEN] = self._rawBytes
-            for name in _CLUSTER_WRITTEN:
-                off, width = o[name]
-                ba[off:off + width] = bytes(width)
-        else:
-            # 서버가 준 바이트가 없는 **새 객체만** status 를 쓴다. 0x00 으로 두면
-            # 엔진이 0 으로 읽는데 **0 은 어느 상태도 아니다**(STOPPED 는 1 이다).
-            # 왔복일 때는 받은 값을 그대로 나른다 - 읽기만 하는 자리를 다시 쓰지 않는다.
-            ba_merge(self.status, ba, o["status"][0], o["status"][1])
-        ba_merge(CLUSTER_LAYOUT_MARK, ba, o["layoutVersion"][0], o["layoutVersion"][1] - 1)
-        ba_merge(self.name, ba, o["name"][0], o["name"][1] - 1)
-        ba_merge("AUTO" if self.autoStart else "MANUAL", ba,
-                 o["startMode"][0], o["startMode"][1])
-        ba_merge(self.heartbeatIntervalMs, ba, o["heartbeatIntervalMs"][0],
-                 o["heartbeatIntervalMs"][1])
-        ba_merge(self.heartbeatMissCount, ba, o["heartbeatMissCount"][0],
-                 o["heartbeatMissCount"][1])
-        ba_merge(self.electionDelayMs, ba, o["electionDelayMs"][0], o["electionDelayMs"][1])
-        for _name in ("controllerHeartbeatIntervalMs", "controllerElectionTimeoutMs",
-                      "replicas", "minSync"):
-            _v = getattr(self, _name)
-            if _v is not None:              # 0 은 "0" 으로, None 은 빈칸으로
-                ba_merge(_v, ba, o[_name][0], o[_name][1])
-        for _name in ("placement", "autoRebalance"):
-            _v = getattr(self, _name)
-            if _v:                          # None / "" 은 빈칸 = 엔진이 저장값 유지
-                ba_merge(str(_v), ba, o[_name][0], o[_name][1])
-        offset = _CLUSTER_LEN
-        ba_merge(len(self.nodes), ba, offset, ILC.MIMQ_LIST_SIZE_LENGTH)
-        offset += ILC.MIMQ_LIST_SIZE_LENGTH
-        for node in self.nodes:
-            ba[offset:offset + _NODE_LEN] = node.get_serialized()
-            offset += _NODE_LEN
-        return bytes(ba)
-
     def __str__(self) -> str:
         """사람이 읽는 요약(운영 화면 출력용).
 

{jetstream_api-0.22.1 → jetstream_api-0.22.3}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.22.1
+Version: 0.22.3
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003
@@ -60,12 +60,29 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.22.3 변경 - 옛 클러스터 블롭 코덱 · actingCoordinator 제거, servicePorts (자바 v2.18.3 와 같음, 짝 엔진 7.0.1.3603 이상 권장)
+
+0.22.2 는 시험 판(test.pypi)만 내고 버렸다 - actingCoordinator 제거를 묶어 0.22.3 으로 나간다.
+
+- **없앰**(호환 깨짐): 옛 고정폭 클러스터 블롭 코덱 - ``ILClusterProperty(bytes)`` · ``ba=`` · ``get_serialized`` · ``get_serialized_length`` ·
+  ``LAYOUT_MARK``, ``ILClusterNode(bytes)`` · ``ba=`` · ``base=`` · ``get_serialized``, 모듈 ``CLUSTER_LAYOUT_MARK``,
+  ``ILC.MIMQ_VO_CLUSTER_LEN`` / ``MIMQ_VO_CLUSTER_NODE_LEN``. 바이트를 주면 ``TypeError``. 엔진 r3601 이 그 형식을 지웠고 0.22.0 부터
+  JSON(Property v2)으로만 주고받아 쓰는 경로가 없었다. 능력 선언 ``clsblob=2`` 는 그대로.
+- **없앰**(호환 깨짐): ``ILClusterProperty.actingCoordinator`` · ``get_acting_coordinator`` / ``getActingCoordinator`` - 0.18.1 부터 폐기 예정,
+  엔진 7.0.1.3484 부터 늘 ``None`` 이던 관측 칸이다(엔진 r3604 도 걷음). ``controllerLeader`` 를 읽는다 - 옛 이름으로 부르면 그렇게 안내한다.
+- **더함**: ``ILClusterProperty.servicePorts`` / ``getServicePorts()`` (읽기 전용) - 응답한 서비스가 맡은 컨트롤러(ilcc) 자리의 포트 전부
+  (엔진 ``PORT`` "a,b", 맡은 자리가 없으면 빈 목록). 컨트롤러가 멈춰 있어도 나온다 - 지금 듣는 포트는 ``localCtrlPort``.
+- 노드 ``status`` · ``nodeUuid`` · ``defTerm`` · ``defVersion`` 은 이름만 남는다(엔진 r3601 부터 와이어에 없어 늘 빈 값) - 문서를 고침.
+- 문서 정정: 팔로워 거절 ``MIMQE_OPERATION_DENIED (STANDBY)`` 는 **토픽**의 생성 · 변경 · 삭제만이다(쿼터 · 디스크 가드 · 클러스터에는 없다).
+- 엔진 r3603: 클러스터 서명(``signature``) 값의 재료가 정의의 공유 칸 전부로 넓어져 값이 바뀐다(키 · 형식 그대로, 클라 변경 없음).
+
 ## 0.22.1 변경 - 노드 추가 결과에 컨트롤러 기동 여부 (자바 v2.18.1 와 같음, started · wait 는 짝 엔진 7.0.1.3602 이상)
 
 - ``addNode`` 결과(``ILClusterNodeAddResult``)에 ``started`` · ``wait``(``is_started()``): 자리를 맡은 서비스가 컨트롤러를 **띄웠는가**와
   안 띄운 까닭(``MANUAL`` - 정의 STARTMODE 가 MANUAL 이라 :meth:`startCluster` 로 띄운다 · ``STOPPED`` - 사용자가 멈춰 둠 · ``FAILED`` -
   띄우다 실패, ilsvc 로그). 그 전 엔진은 이 칸을 주지 않아 맡았으면 띄운 것으로 본다(종전 동작).
-- 문서: 클러스터 팔로워 노드에 보낸 생성 · 변경 · 삭제는 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은 팔로워도 답한다.
+- 문서: **토픽**의 생성 · 변경 · 삭제를 클러스터 팔로워 노드에 보내면 ``MIMQE_OPERATION_DENIED (STANDBY, leader=..)``, 조회 · 목록은
+  팔로워도 답한다. 쿼터 · 디스크 가드 · 클러스터(서비스가 받는 설정)에는 이 거절이 없다(배포 뒤 정정 - 처음에는 네 오브젝트 모두로 잘못 적었다).
 
 ## 0.22.0 변경 - 7 신규 오브젝트(쿼터 · 디스크 가드 · 토픽 · 클러스터) 관리를 Property v2(JSON)로 (자바 v2.18.0 와 같음, 짝 엔진 7.0.1.3601 이상)
 

{jetstream_api-0.22.1 → jetstream_api-0.22.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jetstream-api"
-version = "0.22.1"
+version = "0.22.3"
 description = "Python client API for iLink M.O.M. (Message Oriented Middleware)"
 authors = [{name = "snowjeans"}]
 readme = "README.md"