Function migrateLoadedSettingsData

src/settings/settingsPersistence.ts:105–164

(data: LoadedSettingsData | null)

}

function migrateLoadedSettingsData(data: LoadedSettingsData | null): LoadedSettingsData | null {
	if (!data) {
		return null;
	}

	const migratedData: LoadedSettingsData = { ...data };

	// Migration: Remove old useNativeMetadataCache setting if it exists.
	delete migratedData.useNativeMetadataCache;

	// Migration: Add API settings defaults if they don't exist.
	if (typeof migratedData.enableAPI === "undefined") {
		migratedData.enableAPI = false;
	}
	if (typeof migratedData.apiPort === "undefined") {
		migratedData.apiPort = 8080;
	}
	if (typeof migratedData.apiAuthToken === "undefined") {
		migratedData.apiAuthToken = "";
	}
	if (typeof migratedData.enableMCP === "undefined") {
		migratedData.enableMCP = false;
	}

	// Migration: Migrate statusSuggestionTrigger to nlpTriggers if needed.
	if (!migratedData.nlpTriggers && migratedData.statusSuggestionTrigger !== undefined) {
		migratedData.nlpTriggers = {
			triggers: [...DEFAULT_NLP_TRIGGERS.triggers],
		};

		const statusTriggerIndex = migratedData.nlpTriggers.triggers.findIndex(
			(trigger) => trigger.propertyId === "status"
		);
		if (statusTriggerIndex !== -1 && migratedData.statusSuggestionTrigger) {
			migratedData.nlpTriggers.triggers[statusTriggerIndex].trigger =
				migratedData.statusSuggestionTrigger;
		}
	}

	// Migration: Initialize modal fields configuration if not present.
	if (!migratedData.modalFieldsConfig) {
		migratedData.modalFieldsConfig = initializeFieldConfig(undefined, migratedData.userFields);
	}

	// Migration: Force enableBases to true (issue #1187).
	if (migratedData.enableBases === false) {
		migratedData.enableBases = true;
	}

	// Migration: Update the unused legacy default custom filename template to the
	// preferred double-brace syntax while preserving active custom templates.
	if (
		migratedData.taskFilenameFormat !== "custom" &&
		migratedData.customFilenameTemplate === "{title}"
	) {
		migratedData.customFilenameTemplate = "{{title}}";
	}