Changelog: Fix analysis deadlock caused by lock acquisition order in

vendor file parsing

Author: AJenbo

docs/CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **`throw new` completion no longer offers non-instantiable types.** Interfaces, abstract classes, traits, and enums are now filtered out, matching the behavior of `new` completion. The `throw new` path also now filters to Throwable descendants only.
 - **Unified class name completion architecture.** `throw new` and `catch()` completion now use the same `build_class_name_completions` pipeline as `new`, `extends`, `implements`, etc. `throw new` uses a `ThrowNew` context (instantiable + Throwable) and `catch()`/`@throws` uses a `Catch` context (class or interface + Throwable). This gives both contexts the same affinity scoring, FQN shortening via use-map, namespace segment drill-down, deprecation flags, and consistent filtering. The separate `build_catch_class_name_completions` function has been removed.
 - **Consolidated class completion passes.** The previous 5-pass architecture (use-map, same-namespace, fqn_uri_index, fqn_uri_index duplicate, stub_index) has been simplified to 2 passes (fqn_uri_index + stub_index) with an inline `classify` closure that determines tier (`'0'` use-imported, `'1'` same/sub-namespace, `'2'` everything else) per candidate. The redundant pass 4 (identical to pass 3) is eliminated, and tier assignment is now based on proximity checks rather than which data source produced the item.
+- **Analysis deadlock.** Lazily-parsed vendor files acquired two internal locks in the opposite order from the editor's file-change handler, causing a deadlock when both ran concurrently.
 
 ## [0.8.0] - 2026-05-14
 

src/resolution.rs

@@ -444,13 +444,12 @@ impl Backend {
 
         // Populate the fqn_index so that `find_class_in_uri_classes_index` can
         // resolve these classes via O(1) hash lookup.  Also populate
-        // fqn_uri_index (FQN -> URI) so that `find_class_file_content` can
-        // locate the source file even after the uri_classes_index entry is cleared
-        // by didClose.  The fqn_uri_index cost is negligible (one string
-        // pair per class).
+        // fqn_uri_index (FQN → URI) so that go-to-definition can locate
+        // the source file even after the uri_classes_index entry is
+        // cleared by didClose.
         {
-            let mut fqn_idx = self.fqn_class_index.write();
             let mut class_idx = self.fqn_uri_index.write();
+            let mut fqn_idx = self.fqn_class_index.write();
             for cls in &arc_classes {
                 if cls.name.starts_with("__anonymous@") {
                     continue;