Struct lspSession

pkg/tools/builtin/lsp/lsp_lifecycle.go:215–226

lspSession is a single live LSP server session. cmd.Wait must be called exactly once per *exec.Cmd; both Wait and Close can race to be the caller. A shared sync.Once runs the wait body in one goroutine and exposes the result via the pre-allocated waitDone channel; both Wait and Close block on waitDo

// exposes the result via the pre-allocated waitDone channel; both Wait
// and Close block on waitDone to observe the process exit.
type lspSession struct {
	h             *lspHandler
	processCancel context.CancelFunc
	stdin         io.WriteCloser
	cmd           *exec.Cmd // captured at construction; never nilled by handler teardown.

	closed atomic.Bool

	waitOnce sync.Once
	waitErr  error
	waitDone chan struct{} // pre-allocated in Connect; closed by the wait goroutine.
}

// Wait blocks until the LSP process exits. Safe to call concurrently with
// Close.