afv-library/plugins/builder/salesforce-development/bin
2026-08-05 00:47:09 +00:00
..
lsp-doctor feat: Fix plugin publish: force-add gitignored plugin artifacts in release-to-public workflow @W-23694342@ 2026-08-05 00:47:09 +00:00
lsp-doctor.bundled.js feat: Fix plugin publish: force-add gitignored plugin artifacts in release-to-public workflow @W-23694342@ 2026-08-05 00:47:09 +00:00
lsp-precheck feat: Fix plugin publish: force-add gitignored plugin artifacts in release-to-public workflow @W-23694342@ 2026-08-05 00:47:09 +00:00
lsp-precheck.bundled.js feat: Fix plugin publish: force-add gitignored plugin artifacts in release-to-public workflow @W-23694342@ 2026-08-05 00:47:09 +00:00
README.md feat: Fix plugin publish: force-add gitignored plugin artifacts in release-to-public workflow @W-23694342@ 2026-08-05 00:47:09 +00:00
sf-lsp-host.bundled.js feat: Fix plugin publish: force-add gitignored plugin artifacts in release-to-public workflow @W-23694342@ 2026-08-05 00:47:09 +00:00
soql-lsp.bundled.js feat: Fix plugin publish: force-add gitignored plugin artifacts in release-to-public workflow @W-23694342@ 2026-08-05 00:47:09 +00:00

bin/ — vendored Salesforce LSP runtime

Prebuilt, vendored artifacts for the salesforce-lsp MCP server. Do not hand-edit — regenerate from source and re-vendor.

This directory (and ../vendor/apex-ls/dist/) is deliberately re-included in the repo-root .gitignore, which otherwise blocks bin/ and dist/. The host resolves these files by fixed plugin-relative path, so they must live here.

File What
sf-lsp-host.bundled.js The salesforce-lsp MCP host (esbuild bundle). Wired in ../.mcp.json. Spawns the Apex + SOQL language servers lazily.
soql-lsp.bundled.js Self-contained SOQL language server (esbuild bundle). Spawned by the host.
lsp-precheck / lsp-precheck.bundled.js PreToolUse pre-deploy Apex-diagnostics gate. Wired via if-field hooks in ../.claude-plugin/plugin.json. Fail-open.
lsp-doctor / lsp-doctor.bundled.js Install-level diagnostic CLI. --json / --no-spawn flags.

The .bundled.js files are single-file esbuild bundles (only Node built-ins are external). The bare lsp-precheck / lsp-doctor are thin bash shims that set CLAUDE_PLUGIN_ROOT and exec node …bundled.js.

Scope: Apex + SOQL only (no LWC)

A full LSP runtime would also vendor a ~36 MB @salesforce/lwc-language-server node_modules tree (spawned by path). This plugin omits it to keep the committed footprint small. The host still registers lwc.* tools, but they return an unavailable envelope here — see the platform-lsp-integrate skill. Apex diagnostics come from the vendored ../vendor/apex-ls/ bundles; SOQL from soql-lsp.bundled.js.

Apex language server

@salesforce/apex-ls is not published to public npm — it is built from the apex-language-support monorepo and committed as a prebuilt bundle at ../vendor/apex-ls/dist/{server.node.js,worker.platform.js}. The pinned version is recorded in ../vendor/apex-ls/VERSION.

That bundle embeds third-party code (data-structure-typed (MIT), the ANTLR4 runtime (BSD-3-Clause), and vscode-jsonrpc (MIT)) with original copyright notices intact — see ../NOTICE for the full attribution, along with the other bundled MCP dependencies.

soql-lsp.bundled.js embeds the same ANTLR4 runtime (used to parse SOQL) and vscode-jsonrpc — also attributed in ../NOTICE.