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>

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