Method mergeWithTemplate

server/modules/configModule.js:169–199

* Merge existing config with template to add missing fields * @param {object} existingConfig - Current config object * @returns {object} Object with { config: mergedConfig, modified: boolean }

(existingConfig)

   * @returns {object} Object with { config: mergedConfig, modified: boolean }
   */
  mergeWithTemplate(existingConfig) {
    const examplePath = this.getConfigExamplePath();
    const templateContent = fs.readFileSync(examplePath, 'utf8');
    const templateConfig = JSON.parse(templateContent);

    // Remove comment-only keys from template
    delete templateConfig['//comment'];

    // Deep merge to handle nested objects
    const mergeResult = this.deepMerge(templateConfig, existingConfig);
    const mergedConfig = mergeResult.merged;
    const modified = mergeResult.fieldsAdded.length > 0;

    // Log all fields that were added
    if (modified) {
      mergeResult.fieldsAdded.forEach(fieldPath => {
        logger.info({ field: fieldPath }, 'Adding missing config field from template');
      });
    }

    // Preserve UUID if it exists, generate if not
    if (existingConfig.uuid) {
      mergedConfig.uuid = existingConfig.uuid;
    } else {
      mergedConfig.uuid = uuidv4();
      logger.info({ uuid: mergedConfig.uuid }, 'Generated new UUID for config');
      // Don't set modified=true here since UUID is expected to be missing on first run
    }

    return { config: mergedConfig, modified };
  }

  ensureConfigExists() {
    // If config already exists, nothing to do