fix: npm registry quality (readme, license files, metadata)

.github/workflows/ci.yml

@@ -32,5 +32,6 @@ jobs:
           node-version: 20
       - run: cargo build --locked
       - run: node scripts/sync-npm-version.mjs --check
+      - run: node scripts/check-npm-quality.mjs
       - run: node npm/hardgate/bin/hardgate.js --version
       - run: node tests/npm-wrapper.test.mjs

.github/workflows/release.yml

@@ -197,15 +197,24 @@ jobs:
           node scripts/sync-npm-version.mjs
           for pkg in hardgate-linux-x64 hardgate-linux-x64-musl hardgate-linux-arm64 hardgate-linux-arm64-musl hardgate-darwin-x64 hardgate-darwin-arm64 hardgate-win32-x64; do
             mkdir -p "npm/$pkg/bin"
+            rm -f "npm/$pkg/bin/.gitkeep"
             tar xzf "/tmp/hg-dist/$pkg.tar.gz" -C /tmp/hg-dist
             if [ "$pkg" = "hardgate-win32-x64" ]; then
               cp "/tmp/hg-dist/$pkg/hardgate.exe" "npm/$pkg/bin/hardgate.exe"
             else
               cp "/tmp/hg-dist/$pkg/hardgate" "npm/$pkg/bin/hardgate"
               chmod +x "npm/$pkg/bin/hardgate"
             fi
+            # Registry quality: every tarball ships README + both licenses.
+            # Platform READMEs are committed stubs; licenses are copied here
+            # so the repo keeps a single copy at the root.
+            cp README.md LICENSE-MIT LICENSE-APACHE "npm/$pkg/"
             ls -lh "npm/$pkg/bin/"
+            (cd "npm/$pkg" && npm pack --dry-run 2>&1 | tail -12)
           done
+          # Main wrapper ships its own npm README; licenses come from root.
+          cp LICENSE-MIT LICENSE-APACHE npm/hardgate/
+          (cd npm/hardgate && npm pack --dry-run 2>&1 | tail -12)
           node tests/npm-wrapper.test.mjs
       # NOTE: the "./" prefix is load-bearing: a bare `npm/<pkg>` arg is
       # parsed as a GitHub `owner/repo` shorthand (git ls-remote failure),

npm/hardgate-darwin-arm64/README.md

@@ -0,0 +1,16 @@
+# hardgate-darwin-arm64
+
+hardgate prebuilt binary: macOS arm64 (Apple Silicon).
+
+This is a platform-specific package. Install the main wrapper instead:
+
+```sh
+npm i -D hardgate
+npx hardgate check
+```
+
+Binaries are delivered via `optionalDependencies`, no postinstall downloads.
+
+Full docs: https://github.com/Tech-Byte-Frontier/hardgate
+
+License: MIT OR Apache-2.0.

npm/hardgate-darwin-arm64/package.json

@@ -2,11 +2,11 @@
   "name": "hardgate-darwin-arm64",
   "version": "0.3.3",
   "description": "hardgate prebuilt binary: macOS arm64 (Apple Silicon)",
-  "license": "MIT OR Apache-2.0",
+  "license": "(MIT OR Apache-2.0)",
   "homepage": "https://github.com/Tech-Byte-Frontier/hardgate",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Tech-Byte-Frontier/hardgate.git"
+    "url": "git+https://github.com/Tech-Byte-Frontier/hardgate.git"
   },
   "os": [
     "darwin"
@@ -15,6 +15,16 @@
     "arm64"
   ],
   "files": [
-    "bin/"
-  ]
+    "bin/",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "author": "Tauan BF <contact@techbytefrontier.com>",
+  "bugs": "https://github.com/Tech-Byte-Frontier/hardgate/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "commonjs"
 }

npm/hardgate-darwin-x64/README.md

@@ -0,0 +1,16 @@
+# hardgate-darwin-x64
+
+hardgate prebuilt binary: macOS x64 (Intel).
+
+This is a platform-specific package. Install the main wrapper instead:
+
+```sh
+npm i -D hardgate
+npx hardgate check
+```
+
+Binaries are delivered via `optionalDependencies`, no postinstall downloads.
+
+Full docs: https://github.com/Tech-Byte-Frontier/hardgate
+
+License: MIT OR Apache-2.0.

npm/hardgate-darwin-x64/package.json

@@ -2,11 +2,11 @@
   "name": "hardgate-darwin-x64",
   "version": "0.3.3",
   "description": "hardgate prebuilt binary: macOS x64 (Intel)",
-  "license": "MIT OR Apache-2.0",
+  "license": "(MIT OR Apache-2.0)",
   "homepage": "https://github.com/Tech-Byte-Frontier/hardgate",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Tech-Byte-Frontier/hardgate.git"
+    "url": "git+https://github.com/Tech-Byte-Frontier/hardgate.git"
   },
   "os": [
     "darwin"
@@ -15,6 +15,16 @@
     "x64"
   ],
   "files": [
-    "bin/"
-  ]
+    "bin/",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "author": "Tauan BF <contact@techbytefrontier.com>",
+  "bugs": "https://github.com/Tech-Byte-Frontier/hardgate/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "commonjs"
 }

npm/hardgate-linux-arm64-musl/README.md

@@ -0,0 +1,16 @@
+# hardgate-linux-arm64-musl
+
+hardgate prebuilt binary: linux arm64 (musl, static — Alpine/Docker).
+
+This is a platform-specific package. Install the main wrapper instead:
+
+```sh
+npm i -D hardgate
+npx hardgate check
+```
+
+Binaries are delivered via `optionalDependencies`, no postinstall downloads.
+
+Full docs: https://github.com/Tech-Byte-Frontier/hardgate
+
+License: MIT OR Apache-2.0.

npm/hardgate-linux-arm64-musl/package.json

@@ -2,11 +2,11 @@
   "name": "hardgate-linux-arm64-musl",
   "version": "0.3.3",
   "description": "hardgate prebuilt binary: linux arm64 (musl, static — Alpine/Docker)",
-  "license": "MIT OR Apache-2.0",
+  "license": "(MIT OR Apache-2.0)",
   "homepage": "https://github.com/Tech-Byte-Frontier/hardgate",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Tech-Byte-Frontier/hardgate.git"
+    "url": "git+https://github.com/Tech-Byte-Frontier/hardgate.git"
   },
   "os": [
     "linux"
@@ -18,6 +18,16 @@
     "musl"
   ],
   "files": [
-    "bin/"
-  ]
+    "bin/",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "author": "Tauan BF <contact@techbytefrontier.com>",
+  "bugs": "https://github.com/Tech-Byte-Frontier/hardgate/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "commonjs"
 }

npm/hardgate-linux-arm64/README.md

@@ -0,0 +1,16 @@
+# hardgate-linux-arm64
+
+hardgate prebuilt binary: linux arm64 (glibc).
+
+This is a platform-specific package. Install the main wrapper instead:
+
+```sh
+npm i -D hardgate
+npx hardgate check
+```
+
+Binaries are delivered via `optionalDependencies`, no postinstall downloads.
+
+Full docs: https://github.com/Tech-Byte-Frontier/hardgate
+
+License: MIT OR Apache-2.0.

npm/hardgate-linux-arm64/package.json

@@ -2,11 +2,11 @@
   "name": "hardgate-linux-arm64",
   "version": "0.3.3",
   "description": "hardgate prebuilt binary: linux arm64 (glibc)",
-  "license": "MIT OR Apache-2.0",
+  "license": "(MIT OR Apache-2.0)",
   "homepage": "https://github.com/Tech-Byte-Frontier/hardgate",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Tech-Byte-Frontier/hardgate.git"
+    "url": "git+https://github.com/Tech-Byte-Frontier/hardgate.git"
   },
   "os": [
     "linux"
@@ -18,6 +18,16 @@
     "glibc"
   ],
   "files": [
-    "bin/"
-  ]
+    "bin/",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "author": "Tauan BF <contact@techbytefrontier.com>",
+  "bugs": "https://github.com/Tech-Byte-Frontier/hardgate/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "commonjs"
 }

npm/hardgate-linux-x64-musl/README.md

@@ -0,0 +1,16 @@
+# hardgate-linux-x64-musl
+
+hardgate prebuilt binary: linux x64 (musl, static — Alpine/Docker).
+
+This is a platform-specific package. Install the main wrapper instead:
+
+```sh
+npm i -D hardgate
+npx hardgate check
+```
+
+Binaries are delivered via `optionalDependencies`, no postinstall downloads.
+
+Full docs: https://github.com/Tech-Byte-Frontier/hardgate
+
+License: MIT OR Apache-2.0.

npm/hardgate-linux-x64-musl/package.json

@@ -2,11 +2,11 @@
   "name": "hardgate-linux-x64-musl",
   "version": "0.3.3",
   "description": "hardgate prebuilt binary: linux x64 (musl, static — Alpine/Docker)",
-  "license": "MIT OR Apache-2.0",
+  "license": "(MIT OR Apache-2.0)",
   "homepage": "https://github.com/Tech-Byte-Frontier/hardgate",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Tech-Byte-Frontier/hardgate.git"
+    "url": "git+https://github.com/Tech-Byte-Frontier/hardgate.git"
   },
   "os": [
     "linux"
@@ -18,6 +18,16 @@
     "musl"
   ],
   "files": [
-    "bin/"
-  ]
+    "bin/",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "author": "Tauan BF <contact@techbytefrontier.com>",
+  "bugs": "https://github.com/Tech-Byte-Frontier/hardgate/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "commonjs"
 }

npm/hardgate-linux-x64/README.md

@@ -0,0 +1,16 @@
+# hardgate-linux-x64
+
+hardgate prebuilt binary: linux x64 (glibc).
+
+This is a platform-specific package. Install the main wrapper instead:
+
+```sh
+npm i -D hardgate
+npx hardgate check
+```
+
+Binaries are delivered via `optionalDependencies`, no postinstall downloads.
+
+Full docs: https://github.com/Tech-Byte-Frontier/hardgate
+
+License: MIT OR Apache-2.0.

npm/hardgate-linux-x64/package.json

@@ -2,11 +2,11 @@
   "name": "hardgate-linux-x64",
   "version": "0.3.3",
   "description": "hardgate prebuilt binary: linux x64 (glibc)",
-  "license": "MIT OR Apache-2.0",
+  "license": "(MIT OR Apache-2.0)",
   "homepage": "https://github.com/Tech-Byte-Frontier/hardgate",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Tech-Byte-Frontier/hardgate.git"
+    "url": "git+https://github.com/Tech-Byte-Frontier/hardgate.git"
   },
   "os": [
     "linux"
@@ -18,6 +18,16 @@
     "glibc"
   ],
   "files": [
-    "bin/"
-  ]
+    "bin/",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "author": "Tauan BF <contact@techbytefrontier.com>",
+  "bugs": "https://github.com/Tech-Byte-Frontier/hardgate/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "commonjs"
 }

npm/hardgate-win32-x64/README.md

@@ -0,0 +1,16 @@
+# hardgate-win32-x64
+
+hardgate prebuilt binary: windows x64.
+
+This is a platform-specific package. Install the main wrapper instead:
+
+```sh
+npm i -D hardgate
+npx hardgate check
+```
+
+Binaries are delivered via `optionalDependencies`, no postinstall downloads.
+
+Full docs: https://github.com/Tech-Byte-Frontier/hardgate
+
+License: MIT OR Apache-2.0.

npm/hardgate-win32-x64/package.json

@@ -2,11 +2,11 @@
   "name": "hardgate-win32-x64",
   "version": "0.3.3",
   "description": "hardgate prebuilt binary: windows x64",
-  "license": "MIT OR Apache-2.0",
+  "license": "(MIT OR Apache-2.0)",
   "homepage": "https://github.com/Tech-Byte-Frontier/hardgate",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Tech-Byte-Frontier/hardgate.git"
+    "url": "git+https://github.com/Tech-Byte-Frontier/hardgate.git"
   },
   "os": [
     "win32"
@@ -15,6 +15,16 @@
     "x64"
   ],
   "files": [
-    "bin/"
-  ]
+    "bin/",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "author": "Tauan BF <contact@techbytefrontier.com>",
+  "bugs": "https://github.com/Tech-Byte-Frontier/hardgate/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "commonjs"
 }