WRNexusJS/editors/vscode/PUBLISHING.md

Publishing the WRNexus VS Code extension

The Marketplace extension identifier is wrnexus.wrnexus. The wrnexus publisher must exist in the Visual Studio Marketplace and the publishing identity must have permission to manage it.

Build and inspect the VSIX

From editors/vscode:

bun install
bun run check
bun run package

Install the resulting wrnexus-<version>.vsix in a clean VS Code profile and verify highlighting, Format Document, completion, snippets, and diagnostics on a .wrn file.

Publish

Choose one of these supported routes:

1. Upload the verified VSIX through the Visual Studio Marketplace publisher management page.

2. Authenticate vsce for the wrnexus publisher and run:

   bun run publish
   

Never commit an Azure token or place it in a command-line argument. For local token-based publishing, provide it through the VSCE_PAT environment variable. For automated publishing, prefer a protected CI secret or Microsoft Entra ID.

Before each release, increment version in package.json, update CHANGELOG.md, run the checks, and inspect the VSIX contents printed by vsce.