summaryrefslogtreecommitdiff
path: root/docs/lsp-evaluation.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/lsp-evaluation.md')
-rw-r--r--docs/lsp-evaluation.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/lsp-evaluation.md b/docs/lsp-evaluation.md
index 0812ebf0..b98ea4c0 100644
--- a/docs/lsp-evaluation.md
+++ b/docs/lsp-evaluation.md
@@ -128,6 +128,26 @@ once, and its language words answer `language server for .x not found`.
A (`nvqpknzm`), B (`stuurqqt`) and C's last state (the parent of
`kvlpprms`) remain whole commits.
+**2026-11-05: an index first, the server second.** The words ask the
+nearest `index.scip` above the file (SCIP, scip-code.org: a protobuf file
+an indexer writes at the project's root) before any server:
+`src/lsp/Scip.zig` reads it, about 350 lines with its tests, keeping each
+document's occurrences and each symbol's information in a fixed region
+(an index of 32 MB at most, its tables 32 MB, two indexes at once). Def,
+type definition, Refs, SelectRefs, `gi`, Subtypes, Supertypes, Symbols,
+WsSymbols, Hover, Callers, Callees and the Callstack tree answer from it
+where it knows the symbol: locally, with no handshake and no index to
+wait for, the Callstack's callers each the function whose definition holds
+the call. The server stays for what an index cannot say (Diagnostics,
+Rename, CodeAction, format, completion, declaration), for a pane with
+unsaved changes, and as the fallback for a file, a place or a symbol the
+index lacks, the call hierarchy included (against the architecture's
+ยง13, which dropped it: Callstack over clangd and rust-analyzer stays for
+a project with no index). Measured on rust-analyzer's index of
+clap_builder 4.6.7 (3.9 MB, 32,795 occurrences, 3.1 MB of tables), in a
+Debug core: the first question reads and parses the index in 3.7 ms, a
+`gd` after it takes 0.14 ms, `gr` 0.6 ms, a 7,463-row Callstack 62 ms.
+
## Recommendation (as written before the decision)
**C (in-process), with B as the answer to a question pardes has not asked yet.**