noisegate-hermes 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# noisegate on npm
+
+This npm package is only a thin installer wrapper for the Python package [`noisegate-hermes`](https://github.com/Tosko4/noisegate).
+
+Noisegate itself is a Python Hermes Agent plugin and CLI. The Python package is canonical.
+
+## Install Noisegate for Hermes
+
+```bash
+npx noisegate install-hermes
+```
+
+If your npm client does not resolve the single-bin shortcut, use the explicit bin name:
+
+```bash
+npx -p noisegate noisegate-hermes-installer install-hermes
+```
+
+The wrapper delegates to:
+
+```bash
+uvx --from noisegate-hermes==<this npm package version> noisegate install-hermes
+```
+
+## Security posture
+
+- No `postinstall` scripts.
+- No bundled Python implementation.
+- No long-lived npm token is required when published through npm trusted publishing.
+- Publish provenance should be enabled in CI.
+- The package exists to reserve the public `noisegate` npm name and provide a safe install entrypoint.

package/bin/noisegate-hermes-installer.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const args = process.argv.slice(2);
+const here = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8'));
+const pythonPackageSpec = `noisegate-hermes==${packageJson.version}`;
+
+function help() {
+  console.log(`Noisegate npm installer wrapper
+
+This npm package is a thin installer for the Python package noisegate-hermes.
+The Python package remains the canonical Noisegate implementation.
+
+Usage:
+  npx noisegate install-hermes [--dry-run] [noisegate install-hermes options]
+  npx -p noisegate noisegate-hermes-installer install-hermes [options]
+
+Security model:
+  - no postinstall scripts
+  - no bundled Python code
+  - delegates to: uvx --from ${pythonPackageSpec} noisegate install-hermes ...
+`);
+}
+
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+  help();
+  process.exit(0);
+}
+
+if (args[0] !== 'install-hermes') {
+  console.error('noisegate npm wrapper only supports: install-hermes');
+  console.error('For the full CLI, install the Python package: noisegate-hermes');
+  process.exit(2);
+}
+
+const uvx = process.env.NOISEGATE_UVX || 'uvx';
+const result = spawnSync(
+  uvx,
+  ['--from', pythonPackageSpec, 'noisegate', 'install-hermes', ...args.slice(1)],
+  { stdio: 'inherit' },
+);
+
+if (result.error) {
+  if (result.error.code === 'ENOENT') {
+    console.error('uvx was not found. Install uv first: https://docs.astral.sh/uv/');
+  } else {
+    console.error(`failed to run uvx: ${result.error.message}`);
+  }
+  process.exit(127);
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "noisegate-hermes",
+  "version": "0.1.0",
+  "description": "Thin npm installer wrapper for the Noisegate Hermes Agent plugin and CLI.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "noisegate": "bin/noisegate-hermes-installer.js",
+    "noisegate-hermes-installer": "bin/noisegate-hermes-installer.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Tosko4/noisegate.git",
+    "directory": "npm/noisegate"
+  },
+  "bugs": {
+    "url": "https://github.com/Tosko4/noisegate/issues"
+  },
+  "homepage": "https://github.com/Tosko4/noisegate#readme",
+  "keywords": [
+    "hermes-agent",
+    "noisegate",
+    "installer",
+    "cli",
+    "agent"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --check bin/noisegate-hermes-installer.js && node --check test-wrapper.js && node test-wrapper.js"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}