ci(publish): fail the release if a published package cannot be imported

[aksumustafa1625]

Refs #71.

The problem

Two releases in a row have shipped artifacts that no consumer can import:

• [bug]: dist/ JS retains @agentscript/* imports after scope rewrite, breaking installed package #35 — dist/ still referenced the internal @agentscript/* scope after the publish rewrite → ERR_MODULE_NOT_FOUND.
• [bug]: @sf-agentscript/agentforce@2.5.34 (latest) still unusable — dist/ compiled against a newer @sf-agentscript/language than package.json pins (missing export nullLiteralValidationPass) #71 — agentforce, compiler and agentforce-dialect were published pinning @sf-agentscript/language@2.5.4 while their dist/ had been compiled against a newer language → SyntaxError: ... does not provide an export named 'nullLiteralValidationPass' and TypeError: ....variantMatch is not a function.

Right now, on npm latest, a bare import of @sf-agentscript/agentforce, @sf-agentscript/compiler and @sf-agentscript/lsp all fail.

Neither bug is visible from inside the workspace, and no unit test can see them: pnpm resolves siblings from source, so the packed manifest is never exercised. The failure only appears once a dependent resolves a sibling from the registry — i.e. only in a real consumer install.

What this adds

scripts/verify-published-packages.mjs — for every publishable workspace package, install <name>@<version> from the registry into a clean temp directory the way a consumer does, then import() its public entry point in a child process. Any failure exits non-zero.

scripts/publish.mjs runs it as step 7, right after changeset publish, so a broken release fails the workflow within minutes instead of being discovered by the first person who installs it.

Design notes (happy to change any of these)

Why post-publish and not CI. I tried the pre-publish version first and it does not work: packing from the workspace always produces a self-consistent set of tarballs, so the stale pin resolves to the local sibling and the check passes while the published artifact is broken. The bug is only observable against the registry, so the check has to run against the registry.

Why npm and not pnpm for the consumer install. pnpm-workspace.yaml sets minimumReleaseAge: 1440, which would refuse to install a package published seconds earlier.

Skips. Four entry points are not bare-importable by design, and each skip reason was confirmed by actually importing the published package rather than assumed:

package	why it is skipped
lsp-server	server entry — a bare import throws Connection input stream is not set… by design
lsp-browser	browser bundle — TypeError: port.addEventListener is not a function in Node
monaco	ships TypeScript source as its entry (src/index.ts)
parser-tree-sitter	native binding — needs a platform-aware check, not a bare import

Packages whose version is not on the registry are skipped (e.g. compile-server, which is publishable but has never been published).

Verification

I could not build the monorepo locally to exercise the full publish path — pnpm install fails on tree-sitter under Node 24, which is #7. So I verified the check itself directly, against the packages that are broken on npm right now. The script takes explicit <name>@<version> specs for exactly this kind of spot-check:

$ node scripts/verify-published-packages.mjs \
    @sf-agentscript/agentforce@2.5.34 @sf-agentscript/compiler@2.7.1 \
    @sf-agentscript/lsp@2.3.8 @sf-agentscript/language@2.18.0 \
    @sf-agentscript/parser@4.0.4 @sf-agentscript/types@0.2.3

Verifying published packages install and import cleanly

  FAIL @sf-agentscript/agentforce@2.5.34
         import failed: SyntaxError: The requested module '@sf-agentscript/language' does not provide an export named 'nullLiteralValidationPass'
  FAIL @sf-agentscript/compiler@2.7.1
         import failed: TypeError: NamedBlock(...).describe(...).discriminant(...).variant(...).variantMatch is not a function
  FAIL @sf-agentscript/lsp@2.3.8
         import failed: TypeError: NamedBlock(...).describe(...).discriminant(...).variant(...).variantMatch is not a function
  ok   @sf-agentscript/language@2.18.0
  ok   @sf-agentscript/parser@4.0.4
  ok   @sf-agentscript/types@0.2.3

3 of 6 published package(s) cannot be imported by a consumer.

$ echo $?
1

It flags all three broken packages with their exact errors and passes the three healthy ones — no false positives. Had this been in place, both #35 and #71 would have failed their release instead of shipping.

pnpm format:check passes on both files (ESLint only covers .ts/.tsx, so the .mjs scripts are not linted).

Not included

This does not fix the stale pins themselves — that is a separate, one-line-per-package change, and you may prefer to fix the root cause in the release flow (a language release added API without a matching version bump for the dependents packed against it). This PR only makes sure that class of mistake can never reach users unnoticed again.

Happy to move the step, rename the script, or widen/narrow the skip list — whatever fits how you want releases gated.

[salesforce-cla]

Thanks for the contribution! Before we can merge this, we need @aksumustafa1625 to sign the Salesforce Inc. Contributor License Agreement.