Add the nuverse publish workflow

Author: arkkln

.github/workflows/publish-nuverse.yml

@@ -0,0 +1,88 @@
+# Publishes the `nuverse` distribution to PyPI on a tag push like `nuverse@0.1.0`.
+# Manual "Run workflow" dispatch builds only, unless you tick `publish`.
+#
+# nuverse is the extensions package: the apps (`+`) and snippets (`/`) a space
+# offers out of the box. nuspace finds it through the `nuspace.extensions`
+# entry point and hard-depends on it. It carries python source only, no node
+# toolchain needed.
+#
+# `nuspace` tags own release semantics for the repo (GitHub Release). This tag
+# does not cut a release, same as `nuspace-ui`.
+#
+# Setup once (PyPI trusted publisher / OIDC, no secrets):
+#   pypi.org -> account -> Publishing -> Add pending publisher
+#     PyPI project name: nuverse
+#     Owner: nustackdev
+#     Repository name: nuspace
+#     Workflow name: publish-nuverse.yml
+#     Environment name: (leave blank)
+#
+# Ordering on a coordinated release: nuverse depends on nuspace and nuspace on
+# nuverse, so push `nuverse@` first, then `nuspace@`. pip resolves the cycle
+# once both are on the index.
+#
+# Release flow:
+#   1. Bump `version` in `pkgs/nuverse/pyproject.toml`.
+#   2. Commit and push to main.
+#   3. `git tag nuverse@X.Y.Z && git push origin nuverse@X.Y.Z`.
+name: Publish nuverse to PyPI
+
+on:
+  push:
+    tags: ["nuverse@*"]
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: "Publish to PyPI (otherwise build only)"
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+  id-token: write   # PyPI trusted publishing (OIDC)
+
+concurrency:
+  group: publish-nuverse
+  cancel-in-progress: false
+
+env:
+  PKG_DIR: pkgs/nuverse
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: verify tag matches pyproject.toml version
+        if: startsWith(github.ref, 'refs/tags/nuverse@')
+        working-directory: ${{ env.PKG_DIR }}
+        run: |
+          TAG_VERSION="${GITHUB_REF#refs/tags/nuverse@}"
+          PKG_VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "tag nuverse@$TAG_VERSION does not match pyproject.toml version $PKG_VERSION"
+            exit 1
+          fi
+
+      # The workspace source for nuspace is dev-only; a hatchling build is
+      # metadata-only, so the wheel carries the plain PyPI requirement.
+      - name: build distribution
+        working-directory: ${{ env.PKG_DIR }}
+        run: uv build --out-dir dist
+
+      - name: publish nuverse
+        if: >-
+          startsWith(github.ref, 'refs/tags/nuverse@') || inputs.publish
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: pkgs/nuverse/dist
+          skip-existing: true

CHANGELOG.md

@@ -4,13 +4,15 @@
 
 - **nuspace** (the runtime, the `nuspace` command) — 0.3.1
 - **nuspace-ui** (the compiled web bundle) — 0.3.0
+- **nuverse** (the apps and snippets a space ships with) — 0.1.0
 
 Below is the changelog for **nuspace** - the full commit stream. Newest first.
 The `nuspace-ui` wheel is the same source tree's vite output and is not tracked
 separately here.
 
 ## Unreleased
 
+- Publish nuverse on its own tag so the extensions ship separately
 - Pick any registered snippet from the / menu
 - An open page runs every cell as soon as you land on it, even after a restart
 - Ship apps and snippets as nuverse, a separate package found on install

pkgs/nuverse/README.md

@@ -0,0 +1,11 @@
+# nuverse
+
+The extensions a [nuspace](https://github.com/nustackdev/nuspace) space offers out of the box: the apps `+` makes and the snippets `/` inserts.
+
+nuspace finds it on install through the `nuspace.extensions` entry point. You don't import it yourself.
+
+```
+pip install nuspace
+```
+
+Early. It tracks nuspace's unreleased v4 and needs it to be useful.

pkgs/nuverse/pyproject.toml

@@ -6,6 +6,7 @@ build-backend = "hatchling.build"
 name = "nuverse"
 version = "0.1.0"
 description = "nuspace extensions: the apps and snippets a space offers out of the box."
+readme = "README.md"
 license = "AGPL-3.0-or-later"
 authors = [{ name = "Gor Arakelyan", email = "gorarkln@gmail.com" }]
 requires-python = ">=3.10"