feat(affine-vscode): npm package manifest + tag-driven publish (issue #104)

In-repo half of #104 so consumers can `npm install
@hyperpolymath/affine-vscode` instead of vendoring mod.js — which is what
makes --vscode-extension's default `require("@hyperpolymath/affine-vscode")`
resolvable downstream.

- packages/affine-vscode/package.json: publish manifest (name, main,
  PMPL license matching the sibling deno.json, repository.directory,
  peerDependencies vscode + optional vscode-languageclient, files
  allowlist, public publishConfig). vscode-languageclient is marked
  optional to match --vscode-extension-no-lc.
- .github/workflows/affine-vscode-publish.yml: publishes on a scoped
  `affine-vscode-v*` tag (kept distinct from the compiler's `v*` tags),
  verifies tag==package version, uses runner-provided Node and a runtime
  $HOME/.npmrc (no committed .npmrc, so the npm/bun blocker stays green).
- README: npm-install section as the primary entry point.

Out of scope (needs npm org/token + other repos): the @hyperpolymath npm
org, first manual publish, and the my-lang / standards consumer ports.

https://claude.ai/code/session_01FkzAgzpZFSGxzorVNZ9FUF

Author: claude

.github/workflows/affine-vscode-publish.yml

@@ -0,0 +1,63 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Publishes @hyperpolymath/affine-vscode to npm on a scoped tag push.
+#
+# This repo is Deno-first (see CLAUDE.md). The npm publish here is a
+# deliberate, owner-sanctioned exception (issue #104): the VS Code
+# extension host is npm-native and cannot consume the Deno/JSR manifest,
+# so AffineScript-authored extensions resolve the adapter via
+# `require("@hyperpolymath/affine-vscode")`. Only the publish step touches
+# npm; no npm runtime deps are added to the repo and no .npmrc is
+# committed (the auth file is written to $HOME at runtime).
+#
+# Trigger: push a tag matching `affine-vscode-v*` (e.g. affine-vscode-v0.1.0).
+# This pattern is intentionally distinct from the `v*` tags used by the
+# OCaml compiler Release workflow so the two never collide.
+#
+# Requires repository secret NPM_TOKEN (an npm automation token with
+# publish rights to the @hyperpolymath scope).
+
+name: Publish affine-vscode
+
+on:
+  push:
+    tags:
+      - 'affine-vscode-v*'
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Verify tag matches package version
+        working-directory: packages/affine-vscode
+        run: |
+          tag="${GITHUB_REF_NAME#affine-vscode-v}"
+          pkg="$(node -p "require('./package.json').version")"
+          if [ "$tag" != "$pkg" ]; then
+            echo "❌ Tag version ($tag) does not match package.json version ($pkg)" >&2
+            exit 1
+          fi
+          echo "✅ Publishing @hyperpolymath/affine-vscode@$pkg"
+
+      - name: Configure npm auth
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          if [ -z "${NPM_TOKEN}" ]; then
+            echo "❌ NPM_TOKEN secret is not set" >&2
+            exit 1
+          fi
+          echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > "${HOME}/.npmrc"
+
+      - name: Publish to npm
+        working-directory: packages/affine-vscode
+        run: npm publish --access public
+
+      - name: Clean up npm auth
+        if: always()
+        run: rm -f "${HOME}/.npmrc"

packages/affine-vscode/README.adoc

@@ -6,6 +6,17 @@ JS-side adapter for the `stdlib/Vscode.affine` and
 `stdlib/VscodeLanguageClient.affine` binding modules. Issue #35 Phase 2
 deliverable.
 
+== Install
+
+[source,sh]
+----
+npm install @hyperpolymath/affine-vscode
+----
+
+Add it to your extension's `package.json` `dependencies`. `vscode` and
+`vscode-languageclient` are peer dependencies (the latter is optional —
+omit it with `--vscode-extension-no-lc`).
+
 == Usage
 
 === Recommended: `--vscode-extension` (issue #105)

packages/affine-vscode/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@hyperpolymath/affine-vscode",
+  "version": "0.1.0",
+  "description": "JS-side adapter for AffineScript's stdlib/Vscode.affine + stdlib/VscodeLanguageClient.affine binding modules. Resolves each extern fn to a real vscode / vscode-languageclient call and maintains the FFI handle table.",
+  "main": "./mod.js",
+  "license": "PMPL-1.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hyperpolymath/affinescript.git",
+    "directory": "packages/affine-vscode"
+  },
+  "homepage": "https://github.com/hyperpolymath/affinescript/tree/main/packages/affine-vscode",
+  "bugs": "https://github.com/hyperpolymath/affinescript/issues",
+  "keywords": [
+    "affinescript",
+    "vscode",
+    "vscode-extension",
+    "language-server",
+    "wasm",
+    "ffi-adapter"
+  ],
+  "files": [
+    "mod.js",
+    "README.adoc"
+  ],
+  "peerDependencies": {
+    "vscode": "*",
+    "vscode-languageclient": "^9.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vscode-languageclient": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}