Method explainRuntimeQuery

src/api/TaskNotesAPI.ts:1169–1203

(query: unknown)

	}

	private async explainRuntimeQuery(query: unknown): Promise<TaskNotesRuntimeQueryExplainResult> {
		const execution = this.normalizeRuntimeQueryForExecution(query);
		if (!execution.validation.valid) {
			return {
				valid: false,
				issues: execution.validation.issues,
				warnings: execution.validation.warnings,
				notes: ["Query validation failed before execution."],
			};
		}

		const result = await this.queryTasks(query as TaskNotesRuntimeTaskQuery);
		const notes: string[] = [];
		if (execution.normalized.sort.length > 1) {
			notes.push("Only the first sort is currently applied by the TaskNotes filter engine.");
		}
		if (execution.normalized.group.length > 1) {
			notes.push("Only the first group is currently applied by the TaskNotes filter engine.");
		}

		return {
			valid: true,
			query: result.query,
			issues: [],
			warnings: result.warnings ?? [],
			total: result.total,
			matched: result.matched,
			returned: result.returned,
			groups: result.groups,
			appliedSort: result.query.sort.slice(0, 1),
			appliedLimit: result.query.limit,
			appliedOffset: result.query.offset,
			notes,
		};
	}

	private async getFilterOptions() {
		return this.plugin.filterService.getFilterOptions();