Add release and package publishing

Author: diegoochavezz

.github/workflows/package.yml

@@ -0,0 +1,35 @@
+name: package
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://npm.pkg.github.com
+
+      - name: Validate package contents
+        run: |
+          npm run check
+          npm pack --dry-run
+
+      - name: Publish package to GitHub Packages
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,43 @@
+name: release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Validate extension repo
+        run: npm run check
+
+      - name: Build release archive
+        shell: pwsh
+        run: ./scripts/package-release.ps1
+
+      - name: Read package version
+        id: pkg
+        shell: bash
+        run: echo "version=$(node -p \"require('./package.json').version\")" >> "$GITHUB_OUTPUT"
+
+      - name: Publish GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.pkg.outputs.version }}
+          name: WhiteOwl Extension v${{ steps.pkg.outputs.version }}
+          generate_release_notes: true
+          files: dist/whiteowl-extension-v${{ steps.pkg.outputs.version }}.zip

README.md

@@ -112,6 +112,29 @@ The validator checks:
 
 The bundled `lightweight-charts.js` file is intentionally excluded from the comment check because its Apache 2.0 license header must remain intact.
 
+### Releases
+
+Tagged versions publish a packaged browser-extension archive into GitHub Releases.
+
+- Releases page: `https://github.com/whiteowl-engine/WhiteOwl-Extension/releases`
+- Release asset format: `whiteowl-extension-v<version>.zip`
+- Packaging command: `npm run package:release`
+
+The release archive is built from the runtime extension files only, so it can be downloaded and loaded directly as an unpacked extension after extraction.
+
+### Packages
+
+This repository also publishes the source package to GitHub Packages.
+
+- Package name: `@whiteowl-engine/extension`
+- Registry: `https://npm.pkg.github.com`
+
+Preview the publish payload locally:
+
+```bash
+npm run package:preview
+```
+
 ## Backend Integration
 
 The extension is not a fully isolated product. It is a companion layer for the WhiteOwl panel.
@@ -152,20 +175,4 @@ The extension also injects content scripts and provider logic into the trading,
 This repository currently vendors TradingView Lightweight Charts in `lightweight-charts.js`.
 
 - License: Apache License 2.0
-- Notice file: `THIRD_PARTY_NOTICES.md`
-
-## Suggested Repository Positioning
-
-Recommended GitHub description:
-
-`Open-source browser extension and wallet companion for the WhiteOwl panel.`
-
-Recommended topics:
-
-- `whiteowl`
-- `chrome-extension`
-- `manifest-v3`
-- `solana`
-- `wallet`
-- `sidepanel`
-- `ai`
+- Notice file: `THIRD_PARTY_NOTICES.md`

package.json

@@ -3,12 +3,57 @@
   "version": "1.1.1",
   "private": false,
   "description": "Standalone WhiteOwl browser extension and wallet companion.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/whiteowl-engine/WhiteOwl-Extension.git"
+  },
+  "homepage": "https://github.com/whiteowl-engine/WhiteOwl-Extension#readme",
+  "bugs": {
+    "url": "https://github.com/whiteowl-engine/WhiteOwl-Extension/issues"
+  },
   "license": "MIT",
   "engines": {
     "node": ">=20"
   },
   "scripts": {
-    "check": "node scripts/validate.mjs"
+    "check": "node scripts/validate.mjs",
+    "package:release": "powershell -ExecutionPolicy Bypass -File ./scripts/package-release.ps1",
+    "package:preview": "npm pack --dry-run",
+    "package:publish": "npm publish"
+  },
+  "files": [
+    "_locales",
+    "2.png",
+    "3.png",
+    "4.png",
+    "5.png",
+    "6.png",
+    "LICENSE",
+    "PRIVACY.md",
+    "README.md",
+    "SECURITY.md",
+    "THIRD_PARTY_NOTICES.md",
+    "background.js",
+    "content.js",
+    "ex.mp4",
+    "i18n-ext.js",
+    "icon128.png",
+    "icon16.png",
+    "icon48.png",
+    "lightweight-charts.js",
+    "logo.png",
+    "manifest.json",
+    "owl.svg",
+    "provider.js",
+    "result_transparent.webm",
+    "screenshots",
+    "sidepanel.css",
+    "sidepanel.html",
+    "sidepanel.js",
+    "swap-progress.webm"
+  ],
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
   },
   "keywords": [
     "whiteowl",

scripts/package-release.ps1

@@ -0,0 +1,62 @@
+param(
+  [string]$Version = ""
+)
+
+$ErrorActionPreference = 'Stop'
+
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$root = Split-Path -Parent $scriptDir
+
+if (-not $Version) {
+  $packageJson = Get-Content (Join-Path $root 'package.json') -Raw | ConvertFrom-Json
+  $Version = $packageJson.version
+}
+
+$distDir = Join-Path $root 'dist'
+$stageDir = Join-Path $distDir ('whiteowl-extension-' + $Version)
+$zipPath = Join-Path $distDir ('whiteowl-extension-v' + $Version + '.zip')
+
+$include = @(
+  '_locales',
+  '2.png',
+  '3.png',
+  '4.png',
+  '5.png',
+  '6.png',
+  'background.js',
+  'content.js',
+  'ex.mp4',
+  'i18n-ext.js',
+  'icon128.png',
+  'icon16.png',
+  'icon48.png',
+  'lightweight-charts.js',
+  'logo.png',
+  'manifest.json',
+  'owl.svg',
+  'provider.js',
+  'result_transparent.webm',
+  'sidepanel.css',
+  'sidepanel.html',
+  'sidepanel.js',
+  'swap-progress.webm'
+)
+
+New-Item -ItemType Directory -Force -Path $distDir | Out-Null
+if (Test-Path $stageDir) { Remove-Item $stageDir -Recurse -Force }
+if (Test-Path $zipPath) { Remove-Item $zipPath -Force }
+New-Item -ItemType Directory -Force -Path $stageDir | Out-Null
+
+foreach ($item in $include) {
+  $source = Join-Path $root $item
+  $target = Join-Path $stageDir $item
+  $targetParent = Split-Path -Parent $target
+  if (-not (Test-Path $source)) {
+    throw "Missing release asset input: $item"
+  }
+  New-Item -ItemType Directory -Force -Path $targetParent | Out-Null
+  Copy-Item $source $target -Recurse -Force
+}
+
+Compress-Archive -Path (Join-Path $stageDir '*') -DestinationPath $zipPath -CompressionLevel Optimal
+Write-Output $zipPath