Class TaskManager

src/utils/TaskManager.ts:41–1242

 * - Keep index updates field-aware so ordinary note edits do not invalidate filter work
 */
export class TaskManager extends Events {
	private app: App;
	private settings: TaskNotesSettings;
	private taskTag: string;
	private excludedFolders: string[];
	private fieldMapper?: FieldMapper;
	private disableNoteIndexing: boolean;
	private storeTitleInFilename: boolean;

	// Initialization state
	private initialized = false;

	// Event listeners for cleanup
	private eventListeners: EventRef[] = [];

	// Debouncing for file changes to prevent excessive updates during typing
	private debouncedHandlers: Map<string, number> = new Map();
	private readonly DEBOUNCE_DELAY = 300; // 300ms delay after user stops typing

	// Write-through fallback for files TaskNotes just wrote before Obsidian metadata is ready.
	private pendingTaskInfoByPath = new Map<string, TaskInfo>();

	// Filter/query indexes, built lazily and maintained incrementally after first use.
	private filterIndexesBuilt = false;
	private indexedTaskPaths: Set<string> = new Set();
	private taskFilterEntries: Map<string, TaskFilterIndexEntry> = new Map();
	private statusIndex: Map<string, Set<string>> = new Map();
	private priorityIndex: Map<string, Set<string>> = new Map();
	private dueDateIndex: Map<string, Set<string>> = new Map();
	private scheduledDateIndex: Map<string, Set<string>> = new Map();
	private tagCounts: Map<string, number> = new Map();
	private contextCounts: Map<string, number> = new Map();
	private projectCounts: Map<string, number> = new Map();

	constructor(app: App, settings: TaskNotesSettings, fieldMapper?: FieldMapper) {
		super();
		this.app = app;
		this.settings = settings;
		this.taskTag = settings.taskTag;
		this.excludedFolders = parseExcludedFolders(settings.excludedFolders);
		this.fieldMapper = fieldMapper;
		this.disableNoteIndexing = settings.disableNoteIndexing;
		this.storeTitleInFilename = settings.storeTitleInFilename;
	}

	/**
	 * Initialize by setting up native event listeners
	 */
	initialize(): void {
		if (this.initialized) {
			return;
		}

		this.setupNativeEventListeners();
		this.initialized = true;
		this.trigger("cache-initialized", { message: "Task manager ready" });
	}