Qa 139 vscode smoke (#320)

* test(vscode): in-editor smoke harness via @vscode/test-electron (Closes #139)

Adds editors/vscode/test/ — a headless extension-host runner that loads
the compiled out/extension.cjs in a real VS Code and asserts the four
acceptance bullets from #139:

  1. activation without error
  2. all five affinescript.* commands register and invoke
  3. restartLsp cycles cleanly (back-to-back invocations resolve)
  4. deactivate resolves without throwing

Wires a vscode-smoke job into .github/workflows/ci.yml (Node 20 +
xvfb-run + `npm test`). The compiled extension.cjs is already checked
in (#35 Phase 3), so the smoke job needs only the Node-side test deps —
not the OCaml toolchain.

The Node-only runner is recorded as the second Runtime Exemption in
.claude/CLAUDE.md, paralleling the existing affine-vscode-publish.yml
carve-out (#104). Scope is strictly editors/vscode/test/; no production
code adopts Node.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs(vscode): document #139 smoke harness in README + CAPABILITY-MATRIX

- editors/vscode/README.md gains a "Smoke testing the compiled extension"
  subsection under Contributing: run instructions, what the harness
  asserts, the LSP-attach env-var escape hatch, pointer to the
  Runtime Exemption in CLAUDE.md.
- docs/CAPABILITY-MATRIX.adoc Node-CJS row gains the live-host smoke
  status (was missing — the row only attested the .cjs compile path).

Refs #139, PR #317.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: hyperpolymath

docs/CAPABILITY-MATRIX.adoc

@@ -148,7 +148,11 @@ target spec is the separate `hyperpolymath/typed-wasm` repo.
 `--deno-esm` / `.deno.js`. Shipped + consumer-verified (ubicity).
 
 |Node-CJS |works |`lib/codegen_node.ml`; CJS shim, handle table, the
-`.affine` VS Code extension compiles through it.
+`.affine` VS Code extension compiles through it. Live-host smoke
+harness for the compiled extension landed via PR #317 / issue #139:
+`@vscode/test-electron` + Mocha under `editors/vscode/test/` runs in
+the `vscode-smoke` CI job, asserting activation, command registration,
+`restartLsp` cycling, and `deactivate` teardown.
 
 |Julia, JS, Rust, Lua |works (transpile) |`Module_loader.flatten_imports`
 inlines imported public fns; smoke-tested.

editors/vscode/README.md

@@ -112,6 +112,39 @@ fn main() -> Unit / IO {
 
 Contributions welcome! See [CONTRIBUTING.md](https://github.com/hyperpolymath/affinescript/blob/main/CONTRIBUTING.md)
 
+### Smoke testing the compiled extension
+
+The extension source of truth is [`src/extension.affine`](src/extension.affine);
+it compiles to [`out/extension.cjs`](out/extension.cjs) which is what VS Code
+loads. A headless smoke harness verifies the compiled `.cjs` against the
+acceptance criteria in
+[issue #139](https://github.com/hyperpolymath/affinescript/issues/139):
+activation, command registration + invocation, `restartLsp` cycling, and
+`deactivate` teardown.
+
+To run it locally:
+
+```bash
+cd editors/vscode
+npm install              # one-time: fetches @vscode/test-electron, mocha, glob
+xvfb-run npm test        # on Linux servers (or `npm test` on a desktop)
+```
+
+`@vscode/test-electron` downloads a pinned VS Code binary on first run, launches
+it with `--extensionDevelopmentPath` pointing at this directory, and runs the
+Mocha suite at [`test/suite/`](test/suite/) inside the extension host. The
+[`vscode-smoke`](../../.github/workflows/ci.yml) CI job runs the same harness
+under xvfb on every PR.
+
+Notes:
+
+- The harness covers the documented `showWarningMessage` short-circuit when
+  `affinescript-lsp` is not on `PATH`. Set `AFFINESCRIPT_LSP_PATH` to a real
+  binary if you want to exercise the LSP-attach branch end-to-end.
+- The Node-only runner is a documented carve-out from the repo's
+  "no Node.js / no Bun" policy (see `.claude/CLAUDE.md` → Runtime Exemptions).
+  Scope is strictly `editors/vscode/test/`; no production code adopts Node.
+
 ## License
 
 PMPL-1.0-or-later