@remnic/coding-graph 9.6.38 → 9.7.0

package/dist/index.d.ts

@@ -1183,6 +1183,15 @@ declare function planLspUpgrades(callSites: readonly UnresolvedCallSite[], budge
 interface ResolveOptions {
     readonly client: LspClient;
     readonly nodeLocator: NodeLocator;
+    /**
+     * Warm-up retry delay in ms (issue #1933). Language servers (tsserver
+     * in particular) load projects ASYNCHRONOUSLY after `didOpen`; a
+     * definition request that arrives too early returns an EMPTY location
+     * array — indistinguishable from "definitely no definition". Until the
+     * server has proven warm (any non-empty response), an empty result is
+     * retried ONCE after this delay. Default 2500. Set 0 to disable.
+     */
+    readonly warmupRetryDelayMs?: number;
     /**
      * Apply a batch of edge upgrades atomically. Called once per file batch.
      * MUST be transactional — if it throws, zero upgrades from this batch

package/dist/index.js

@@ -2944,6 +2944,8 @@ async function executeLspResolution(requests, options) {
   let upgraded = 0;
   let unresolved = 0;
   let degradation;
+  let serverWarm = false;
+  const warmupRetryDelayMs = options.warmupRetryDelayMs ?? 2500;
   for (const [filePath, batchReqs] of byFile) {
     const upgrades = [];
     let batchFailed = false;
@@ -2961,10 +2963,22 @@ async function executeLspResolution(requests, options) {
         unresolved += batchReqs.length - i;
         break;
       }
-      const defResult = await client.definition({
+      let defResult = await client.definition({
         textDocument: { uri: filePathToUri(req.filePath, options.workspaceRoot) },
         position: req.position
       });
+      if (defResult.ok && defResult.locations.length === 0 && !serverWarm && warmupRetryDelayMs > 0) {
+        await new Promise((resolve) => setTimeout(resolve, warmupRetryDelayMs));
+        serverWarm = true;
+        const retryResult = await client.definition({
+          textDocument: { uri: filePathToUri(req.filePath, options.workspaceRoot) },
+          position: req.position
+        });
+        defResult = retryResult;
+      }
+      if (defResult.ok && defResult.locations.length > 0) {
+        serverWarm = true;
+      }
       if (!defResult.ok) {
         if (defResult.degradation.code === "server_crashed" || defResult.degradation.code === "protocol_error") {
           degradation = defResult.degradation;