feat: add Deno binary compilation

.github/workflows/deno-binaries.yml

@@ -0,0 +1,101 @@
+name: Deno Binaries
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  build-linux:
+    name: Build (Linux)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Deno
+        uses: denoland/setup-deno@v1
+        with:
+          deno-version: v2.x
+
+      - name: Slim package.json (prod deps only)
+        run: |
+          mv package.json package.full.json
+          deno eval "const p = JSON.parse(await Deno.readTextFile('package.full.json')); const out = { name: p.name, version: p.version, private: true, type: p.type, dependencies: p.dependencies }; await Deno.writeTextFile('package.json', JSON.stringify(out, null, 2) + '\n');"
+
+      - name: Compile
+        run: |
+          deno task compile:linux-x64
+          deno task compile:linux-arm64
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: deno-binaries-linux
+          path: dist-deno/*
+
+  build-macos:
+    name: Build (macOS)
+    runs-on: macos-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Deno
+        uses: denoland/setup-deno@v1
+        with:
+          deno-version: v2.x
+
+      - name: Slim package.json (prod deps only)
+        run: |
+          mv package.json package.full.json
+          deno eval "const p = JSON.parse(await Deno.readTextFile('package.full.json')); const out = { name: p.name, version: p.version, private: true, type: p.type, dependencies: p.dependencies }; await Deno.writeTextFile('package.json', JSON.stringify(out, null, 2) + '\n');"
+
+      - name: Compile
+        run: |
+          deno task compile:mac-x64
+          deno task compile:mac-arm64
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: deno-binaries-macos
+          path: dist-deno/*
+
+  upload-release-assets:
+    name: Upload Release Assets
+    runs-on: ubuntu-latest
+    needs: [build-linux, build-macos]
+    if: startsWith(github.ref, 'refs/tags/')
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download Linux artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: deno-binaries-linux
+          path: dist-deno
+
+      - name: Download macOS artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: deno-binaries-macos
+          path: dist-deno
+
+      - name: Generate checksums
+        run: |
+          cd dist-deno
+          sha256sum * > SHA256SUMS.txt
+
+      - name: Upload to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist-deno/*

.gitignore

@@ -85,6 +85,9 @@ out
 .nuxt
 dist
 
+# Deno compiled binaries
+dist-deno/
+
 # Gatsby files
 .cache/
 # Comment in the public line in if your project uses Gatsby and not Next.js

PLUGIN-HELP.md

@@ -12,6 +12,12 @@ When users load plugins, their commands automatically appear in the help text. P
 2. **Plugin Section**: If plugins are loaded, a "Plugin Commands" section appears at the bottom of the help text
 3. **Command Listing**: Each plugin command is listed with its optional description
 
+## Plugin definition
+
+A plugin needs to have `c8ctl-plugin` in the `keywords` array in its `package.json`. This is a requirement to make the plugin loadable by c8ctl.
+
+See the example plugin in the `demo-plugin` directory for a working example.
+
 ## Plugin Structure for Help
 
 Plugins can export an optional `metadata` object alongside the required `commands` object:

demo-plugin/c8ctl-plugin.js

@@ -0,0 +1,16 @@
+// c8ctl-plugin.ts
+export const metadata = {
+  name: 'my-plugin',
+  description: 'My custom c8ctl plugin',
+  commands: {
+    analyze: {
+      description: 'Analyze BPMN processes'
+    }
+  }
+};
+
+export const commands = {
+  analyze: async (args) => {
+    console.log('Analyzing...', args);
+  }
+};

demo-plugin/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "demo-plugin",
+  "version": "1.0.0",
+  "description": "Demonstration plugin for c8ctl",
+  "license": "ISC",
+  "author": "",
+  "type": "module",
+  "main": "c8ctl-plugin.js",
+  "keywords": ["c8ctl-plugin"],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

deno.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "lib": ["es2023", "dom"]
+  },
+  "tasks": {
+    "check": "deno check --no-lock src/deno.ts",
+
+    "compile:mac-x64": "mkdir -p dist-deno && deno compile --no-lock --no-check --allow-net --allow-env --allow-sys --allow-read --allow-write --allow-run --target x86_64-apple-darwin --output dist-deno/c8ctl-macos-x64 src/deno.ts",
+    "compile:mac-arm64": "mkdir -p dist-deno && deno compile --no-lock --no-check --allow-net --allow-env --allow-sys --allow-read --allow-write --allow-run --target aarch64-apple-darwin --output dist-deno/c8ctl-macos-arm64 src/deno.ts",
+    "compile:linux-x64": "mkdir -p dist-deno && deno compile --no-lock --no-check --allow-net --allow-env --allow-sys --allow-read --allow-write --allow-run --target x86_64-unknown-linux-gnu --output dist-deno/c8ctl-linux-x64 src/deno.ts",
+    "compile:linux-arm64": "mkdir -p dist-deno && deno compile --no-lock --no-check --allow-net --allow-env --allow-sys --allow-read --allow-write --allow-run --target aarch64-unknown-linux-gnu --output dist-deno/c8ctl-linux-arm64 src/deno.ts",
+
+    "compile:all": "deno task compile:mac-x64 && deno task compile:mac-arm64 && deno task compile:linux-x64 && deno task compile:linux-arm64"
+  }
+}