Method schedule_diagnostics

src/diagnostics/mod.rs:869–912

Notify the diagnostic system that a file needs fresh diagnostics. Push mode:** Queues the file for the debounced background diagnostic worker and schedules external tool runs. Pull mode:** Only schedules external tool runs (PHPStan, PHPCS, Mago). Native diagnostic computation is deferred until the editor sends a `textDocument/diagnostic` pull request, which triggers [`trigger_diagnostics_for_pu

(&self, uri: String)

    /// in the background so that completion, hover, and signature help
    /// are never blocked.
    pub(crate) fn schedule_diagnostics(&self, uri: String) {
        // Don't schedule diagnostics before initialization is complete.
        // Files opened during startup will be diagnosed once
        // `initialized` sets `init_complete` and re-schedules them.
        if !self.init_complete.load(Ordering::Acquire) {
            return;
        }

        let pull_mode = self.supports_pull_diagnostics.load(Ordering::Acquire);

        if pull_mode {
            // Invalidate the cached full diagnostics so the next pull
            // triggers a fresh computation instead of returning stale
            // results.  Do NOT remove the resultId — removing it resets
            // the ID to 0 (via unwrap_or), which can match a stale
            // previousResultId sent by the client and cause the pull
            // handler to return "unchanged" with outdated diagnostics.
            // The resultId is bumped naturally when assemble_and_push
            // caches new results.
            self.diag_last_full.lock().remove(&uri);
        }

        // Both modes: queue for the debounced background worker.
        // In push mode the worker pushes the full assembled set.
        // In pull mode the worker pushes only fast diagnostics and
        // caches the full set in `diag_last_full` for pull responses.
        {
            let mut pending = self.diag_pending_uris.lock();
            if !pending.contains(&uri) {
                pending.push(uri.clone());
            }
        }
        self.diag_version.fetch_add(1, Ordering::Release);
        self.diag_notify.notify_one();

        // Both modes: schedule external tool runs.  In pull mode the
        // external tools still use their own debounce timers because
        // they are expensive and the IDE may send many pulls in
        // quick succession.
        self.schedule_phpstan(uri.clone());
        self.schedule_phpcs(uri.clone());
        self.schedule_mago_lint(uri.clone());
        self.schedule_mago_analyze(uri);
    }

    /// Invalidate diagnostics for all open files after a cross-file change.
    ///