LSP Server

LSP method: initialized

Discovers all reqstool projects under each workspace folder and builds in-memory SQLite databases for each on startup.

LSP method: shutdown

Closes all open project databases gracefully.

LSP method: textDocument/didOpen

Publishes diagnostics for the opened document immediately.

LSP method: textDocument/didChange

Re-runs diagnostics on every content change event.

LSP method: textDocument/didSave

On save of a reqstool YAML file (requirements.yml, svcs.yml, etc.), rebuilds the affected project database and republishes all diagnostics. For source files, re-runs diagnostics for that file only.

LSP method: textDocument/didClose

Clears diagnostics for the closed document.

LSP method: workspace/didChangeWorkspaceFolders

Adds or removes project databases when workspace folders are added or removed in the client.

LSP method: workspace/didChangeWatchedFiles

Triggers a full project rebuild when any reqstool YAML file is created, modified, or deleted on disk outside the client.

LSP method: textDocument/hover

In source files: Markdown tooltip for @Requirements/@SVCs IDs — title, description, lifecycle, SVCs, implementation count, and an "Open Details" link. In reqstool YAML files: JSON Schema description for the hovered field.

LSP method: textDocument/completion

In source files: autocompletes requirement and SVC IDs inside @Requirements() and @SVCs() annotations. Trigger characters: ", space, :. In YAML files: completes enum values from the JSON Schema.

LSP method: textDocument/definition

From a source annotation: jumps to the id: line in the YAML file. From svcs.yml (on a requirement reference): jumps to the defining entry in requirements.yml. From mvrs.yml (on an SVC reference): jumps to the defining entry in svcs.yml.

LSP method: textDocument/documentSymbol

Outline view for reqstool YAML files. Requirements show linked SVCs as children; SVCs show requirements and MVRs as children.

LSP method: textDocument/codeLens

Inline summary above @Requirements/@SVCs annotations: SVC count and pass/fail verification results. Clicking opens the Details panel.

LSP method: textDocument/inlayHint

Appends the human-readable title of each requirement or SVC immediately after its ID in source annotations.

LSP method: textDocument/references

Finds all usages of a requirement or SVC ID across open source files and all reqstool YAML files in the project.

LSP method: workspace/symbol

Global search across all loaded projects for requirements and SVCs matching the query string (by ID or title).

LSP method: textDocument/semanticTokens/full

Colorizes requirement and SVC IDs in source annotations by lifecycle state. Four custom token types: reqstoolDraft, reqstoolValid, reqstoolDeprecated, reqstoolObsolete.

LSP method: textDocument/codeAction

QuickFix actions for unknown-ID and deprecated/obsolete diagnostics. Source action on any known annotation to open the Details panel.

Code action kinds: quickfix, source.