refactor: 리펙토링

src/contracts/release-tokens.ts

@@ -12,7 +12,12 @@ export const RELEASE_TOKEN_REGISTRY = Object.freeze({
   apiContractVersion: token(
     "apiContractVersion",
     "frontend/backend agreement",
-    "schema compatibility",
+    "legacy V1 scalar; superseded by contractSetDigest",
+  ),
+  contractSetDigest: token(
+    "contractSetDigest",
+    "compiled external contract package set",
+    "release coherence for multi-package contracts",
   ),
   assetManifestHash: token(
     "assetManifestHash",
@@ -37,23 +42,33 @@ export function compareReleaseToRuntime(
   release: Readonly<{
     buildId: string;
     configSchemaVersion: string;
-    apiContractVersion: string;
+    apiContractVersion?: string;
     assetManifestHash: string;
     releaseId: string;
   }>,
   runtimeConfig: Readonly<{
     BUILD_ID: string;
     CONFIG_SCHEMA_VERSION: string;
-    API_CONTRACT_VERSION: string;
+    /**
+     * §5.1. Removed from Runtime Config V2. When neither side declares it there
+     * is nothing to disagree about: contract identity is verified by the
+     * Release Manifest V2 `contractSet` check instead.
+     */
+    API_CONTRACT_VERSION?: string;
     RELEASE_ID: string;
   }>,
 ) {
+  const declaredContractVersion =
+    runtimeConfig.API_CONTRACT_VERSION ?? release.apiContractVersion ?? "0";
   return verifyCompatibilityTuple({
-    frontend: release,
+    frontend: {
+      ...release,
+      apiContractVersion: release.apiContractVersion ?? declaredContractVersion,
+    },
     runtime: {
       buildId: runtimeConfig.BUILD_ID,
       configSchemaVersion: runtimeConfig.CONFIG_SCHEMA_VERSION,
-      apiContractVersion: runtimeConfig.API_CONTRACT_VERSION,
+      apiContractVersion: declaredContractVersion,
       assetManifestHash: release.assetManifestHash,
       releaseId: runtimeConfig.RELEASE_ID,
     },