Function ensureStarterNote

src/bootstrap/starterNote.ts:142–187

(host: StarterNoteHost)

};

export async function ensureStarterNote(host: StarterNoteHost): Promise<StarterNoteResult> {
	if (host.settings.starterNoteCreated) {
		return "already-created";
	}

	if (!host.shouldCreateStarterNote) {
		return "not-first-install";
	}

	const normalizedPath = normalizePath(STARTER_NOTE_PATH);

	try {
		const vault = host.app.vault;
		const existing = await vault.adapter.exists(normalizedPath);
		let file: TFile;
		let result: StarterNoteResult = "created";

		if (existing) {
			const existingFile = vault.getAbstractFileByPath(normalizedPath);
			if (!(existingFile instanceof TFile)) {
				host.warn?.(
					`[TaskNotes][StarterNote] Starter note path exists but is not a file: ${normalizedPath}`
				);
				return "path-not-file";
			}
			file = existingFile;
			result = "opened-existing";
		} else {
			const lastSlashIndex = normalizedPath.lastIndexOf("/");
			const directory =
				lastSlashIndex >= 0 ? normalizedPath.substring(0, lastSlashIndex) : "";
			if (directory) {
				await ensureFolderHierarchy(vault, directory);
			}
			file = await vault.create(normalizedPath, STARTER_NOTE_CONTENT);
		}

		host.settings.starterNoteCreated = true;
		await host.saveSettings();
		await host.app.workspace.getLeaf("tab").openFile(file);
		return result;
	} catch (error) {
		host.warn?.("[TaskNotes][StarterNote] Failed to create starter note:", error);
		return "failed";
	}
}