docs: inventory removable Ref compatibility shims

packages/logic/src/actions/turn/general/che_물자조달.ts

@@ -25,7 +25,9 @@ interface ProcureContext<
 const ACTION_NAME = '물자조달';
 const ACTION_KEY = 'che_물자조달';
 
+// REF-COMPAT:BEGIN ref-int-column-write-rounding
 export const roundLegacyAccumulatedInteger = (current: number, delta: number): number => Math.round(current + delta);
+// REF-COMPAT:END ref-int-column-write-rounding
 
 export const resolveLegacyExperienceLevel = (experience: number): number =>
     Math.max(

packages/logic/src/actions/turn/general/che_징병.ts

@@ -60,12 +60,14 @@ const DEFAULT_MIN_POP = 30000;
 const DEFAULT_TRUST = 50;
 const MIN_CREW = 100;
 
+// REF-COMPAT:BEGIN ref-php-half-rounding
 // PHP round() compensates for the small binary drift around a half boundary.
 // Ref then converts the result to int through Util::round().
 export const roundLegacyRecruitCost = (value: number): number => {
     const corrected = value + Math.sign(value) * Number.EPSILON * Math.max(1, Math.abs(value));
     return corrected < 0 ? Math.ceil(corrected - 0.5) : Math.floor(corrected + 0.5);
 };
+// REF-COMPAT:END ref-php-half-rounding
 
 export const ARGS_SCHEMA = z.preprocess(
     (raw) => {

packages/logic/src/actions/turn/general/legacyCityTrust.ts

@@ -5,6 +5,8 @@
  */
 import { readLegacyStoredFloat, toLegacyStoredFloat } from '@sammo-ts/logic/compat/legacyFloat.js';
 
+// REF-COMPAT:BEGIN ref-mariadb-float-boundary
 export const storeLegacyCityTrust = (value: number): number => toLegacyStoredFloat(value);
 
 export const readLegacyCityTrust = (value: number): number => readLegacyStoredFloat(value);
+// REF-COMPAT:END ref-mariadb-float-boundary

packages/logic/src/actions/turn/general/legacyGeneralStat.ts

@@ -1,3 +1,5 @@
+// REF-COMPAT:BEGIN ref-stat-injury-truncation
 export const applyLegacyInjury = (value: number, injury: number): number => value * ((100 - injury) / 100);
 
 export const finalizeLegacyStat = (value: number): number => Math.trunc(value);
+// REF-COMPAT:END ref-stat-injury-truncation