Function assertDataDirCompatible

packages/node-runtime/src/data-dir-compat.ts:84–132

(
  pathProvider: PathProvider,
  runtime: RuntimeIdentity,
  options: AssertDataDirCompatibilityOptions = {}
)

}

export function assertDataDirCompatible(
  pathProvider: PathProvider,
  runtime: RuntimeIdentity,
  options: AssertDataDirCompatibilityOptions = {}
): void {
  const userDataDir = pathProvider.getUserDataDir()
  const meta = readDataDirCompatibilityMeta(userDataDir)
  if (!meta) return

  const runtimeStableVersion = normalizeRuntimeStableVersion(runtime.version)
  if (!runtimeStableVersion) {
    throw new DataDirCompatibilityError(
      'DATA_DIR_REQUIRES_NEWER_RUNTIME',
      `ChatLab data directory compatibility check requires a valid runtime semver; current version is ${runtime.version}.`,
      {
        userDataDir,
        metaPath: getMetaPath(userDataDir),
        currentVersion: runtime.version,
        minRuntimeVersion: meta.minRuntimeVersion,
      }
    )
  }

  if (compareStableSemver(runtimeStableVersion, meta.minRuntimeVersion) < 0) {
    const env = options.env ?? process.env
    if (env.CHATLAB_ALLOW_INCOMPATIBLE_DATA_DIR === '1') {
      const warn = options.warn ?? console.warn
      warn(
        [
          'CHATLAB_ALLOW_INCOMPATIBLE_DATA_DIR=1 is set. ChatLab will bypass the data directory runtime version gate.',
          `Current runtime ${runtime.kind}@${runtime.version} is below required version ${meta.minRuntimeVersion}.`,
          `Data directory: ${userDataDir}. Continuing may risk data corruption.`,
        ].join(' ')
      )
      return
    }

    throw new DataDirCompatibilityError(
      'DATA_DIR_REQUIRES_NEWER_RUNTIME',
      `ChatLab data directory requires runtime version ${meta.minRuntimeVersion} or newer; current version is ${runtime.version}.`,
      {
        userDataDir,
        metaPath: getMetaPath(userDataDir),
        currentVersion: runtime.version,
        minRuntimeVersion: meta.minRuntimeVersion,
      }
    )
  }
}

export function raiseDataDirMinRuntimeVersion(
  pathProvider: PathProvider,