From 5d67d76cc0d0559f6f39c33043b6ef3b701c83d9 Mon Sep 17 00:00:00 2001
From: LukeGus <bugattiguy527@gmail.com>
Date: Mon, 5 Oct 2026 18:32:48 -0500
Subject: [PATCH] feat: add a publish workflow for the plugin sdk

---
 .github/workflows/publish-sdk.yml | 72 +++++++++++++++++++++++++++++++
 packages/plugin-sdk/README.md     | 10 -----
 2 files changed, 72 insertions(+), 10 deletions(-)
 create mode 100644 .github/workflows/publish-sdk.yml

diff --git a/.github/workflows/publish-sdk.yml b/.github/workflows/publish-sdk.yml
new file mode 100644
index 000000000..c7673c2af
--- /dev/null
+++ b/.github/workflows/publish-sdk.yml
@@ -0,0 +1,72 @@
+name: Publish SDK
+
+# Publishes packages/plugin-sdk to npm as @termix-ssh/plugin-sdk with trusted
+# publishing, so there is no npm token. The version is whatever
+# packages/plugin-sdk/package.json says; bump it before running this.
+
+on:
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: "Publish mode"
+        required: true
+        default: Publish
+        type: choice
+        options:
+          - Publish
+          - Dry run
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    name: Publish @termix-ssh/plugin-sdk
+    # Trusted publishing only works on GitHub-hosted runners.
+    runs-on: ubuntu-latest
+
+    env:
+      NODE_OPTIONS: "--max-old-space-size=4096"
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-node@v7
+        with:
+          node-version-file: ".nvmrc"
+          cache: npm
+          registry-url: https://registry.npmjs.org
+
+      - name: Update npm
+        run: npm install -g npm@^11.19.0
+
+      - run: npm ci
+
+      - name: Check the version is new
+        run: |
+          VERSION=$(node -p "require('./packages/plugin-sdk/package.json').version")
+          if npm view "@termix-ssh/plugin-sdk@$VERSION" version >/dev/null 2>&1; then
+            echo "@termix-ssh/plugin-sdk@$VERSION is already on npm. Bump packages/plugin-sdk/package.json first."
+            if [ "${{ inputs.mode }}" = "Publish" ]; then
+              exit 1
+            fi
+          fi
+          echo "Publishing @termix-ssh/plugin-sdk@$VERSION"
+
+      - run: npm run build:sdk
+
+      # The SDK's ui and test host are built from core, so check core too.
+      - run: npm run lint
+
+      - run: npm run type-check
+
+      - run: npm run test
+
+      - name: Publish
+        run: |
+          if [ "${{ inputs.mode }}" = "Dry run" ]; then
+            npm publish --workspace @termix-ssh/plugin-sdk --provenance --access public --dry-run
+          else
+            npm publish --workspace @termix-ssh/plugin-sdk --provenance --access public
+          fi
diff --git a/packages/plugin-sdk/README.md b/packages/plugin-sdk/README.md
index 4e61ccd1c..0702434e3 100644
--- a/packages/plugin-sdk/README.md
+++ b/packages/plugin-sdk/README.md
@@ -16,16 +16,6 @@
 
 <br />
 
-## What's Inside
-
-- **Backend:** the types for `activate(ctx)`, database and table helpers, host commands and SSH certificates
-- **Frontend:** the types for `activate(app)`, plus `@termix-ssh/plugin-sdk/ui`, the components and theme Termix serves to plugins
-- **Manifest:** the manifest schema, the capability catalog and settings types
-- **Testing:** `createMockCtx()`, `createTestDb()`, `renderWithApp()` and a Vitest preset
-- **CLI:** `termix-plugin`, which builds, tests, validates, packs and signs a plugin and writes its migrations
-
-<br />
-
 ## Installation
 
 ```bash