Function getGroupTasks

src/bases/sortOrderUtils.ts:465–543

(
	groupKey: string | null,
	groupByProperty: string | null,
	plugin: TaskNotesPlugin,
	options: SortOrderComputationOptions = {}
)

 * Get all tasks matching a group, narrowed by optional extra scope filters.
 */
export function getGroupTasks(
	groupKey: string | null,
	groupByProperty: string | null,
	plugin: TaskNotesPlugin,
	options: SortOrderComputationOptions = {}
): TaskInfo[] {
	const sortOrderField = plugin.settings.fieldMapping.sortOrder;
	const visibleOrder = buildVisibleOrderLookup(options.visibleTaskPaths);
	const candidateTaskPathSet = options.candidateTaskPaths
		? new Set(options.candidateTaskPaths)
		: null;
	const allFiles = plugin.app.vault.getMarkdownFiles();
	const tasks: TaskInfo[] = [];

	for (const file of allFiles) {
		if (candidateTaskPathSet && !candidateTaskPathSet.has(file.path)) {
			continue;
		}

		const frontmatter = plugin.app.metadataCache.getFileCache(file)?.frontmatter;
		if (!frontmatter) continue;

		if (
			groupKey !== null &&
			groupByProperty &&
			!matchesGroupValue(frontmatter[groupByProperty], groupKey)
		) {
			continue;
		}

		if (
			options.scopeFilters?.some(
				(filter) => !matchesGroupValue(frontmatter[filter.property], filter.value)
			)
		) {
			continue;
		}

		const rawSortOrder = frontmatter[sortOrderField];
		const sortOrder = rawSortOrder !== undefined ? String(rawSortOrder) : undefined;
		const cached = options.taskInfoCache?.get(file.path);
		if (cached) {
			cached.sortOrder = sortOrder;
			tasks.push(cached);
			continue;
		}

		tasks.push({
			path: file.path,
			title: file.basename,
			status: frontmatter["status"] || "open",
			priority: frontmatter["priority"] || "",
			archived: frontmatter["archived"] || false,
			sortOrder,
		});
	}

	tasks.sort((a, b) => {