@naisys/hub 3.0.0-beta.35 → 3.0.0-beta.36

package/README.md

@@ -4,48 +4,56 @@
 
 The hub is the central server and source of truth for a NAISYS cluster. Runners and supervisors connect over WebSocket + REST; the hub owns persistence (mail, context logs, cost, variables) so runners are ephemeral and can be restarted or moved between machines without losing state.
 
-Run standalone with `npx naisys_hub`, or in-process with `npx naisys --integrated-hub`.
+## Running
+
+Most installations run the hub in-process with the supervisor UI and ERP — see the [main README](../../README.md). To run the hub alone:
+
+```bash
+npm install @naisys/hub
+npx naisys-hub
+```
+
+Hosts then connect with `npx naisys --hub=https://<server>/hub`. If the hub isn't already public, expose it with a reverse proxy or [ngrok](https://ngrok.com/).
+
+> **Note:** Remote auto-update from the supervisor UI only works when the hub runs attached to a `naisys` runner (the integrated stack). Running `naisys-hub` solo skips the runner that performs the update.
+
+## Configuration
+
+Standalone hub reads configuration from `.env`:
+
+- `NAISYS_FOLDER` - persistent data folder for the hub database, logs, and access key
+- `SERVER_PORT` - HTTP port; defaults to `3300`
 
 ## Features
 
 ### Core
 
-- WebSocket + REST server with persistence
-- `hub-protocol` shared-types package between hub and clients for compile-time safety
-- Heartbeat service tracks online runners/supervisors and agent status
-- Run-session tracking per run with keep-alive and authoritative online/offline state
+- WebSocket + REST server with `hub-protocol` shared types between hub and clients
+- Heartbeat service for online runners/supervisors and agent status
+- Run-session tracking with keep-alive and authoritative online/offline state
 - Per-app host filter (naisys-host vs supervisor-host)
 
 ### Persistence ([doc 001](../../docs/001-database-design.md))
 
-The hub owns all shared data, so runners stay ephemeral:
-
-- Mail
-- Context log and attachments ([doc 011](../../docs/011-mail-attachments.md))
-- Cost tracking
-- Variables
+The hub owns mail, context logs and [attachments](../../docs/011-mail-attachments.md), cost history, and variables, so runners stay ephemeral and replaceable.
 
-### Multi-machine
+### Multi-machine ([doc 005](../../docs/005-multi-machine-redux.md))
 
-- Hub is the single source of truth ([doc 005](../../docs/005-multi-machine-redux.md)); runners are ephemeral
-- Duplicate host-connection prevention; a new connection supersedes a dead one
+- Hub is the single source of truth; runners are ephemeral
+- Duplicate host-connection prevention — a new connection supersedes a dead one
 
 ### Security ([doc 010](../../docs/010-hub-security.md))
 
-- `Authorization: Bearer` header auth
-- Rotatable hub access key
-- Hardened spawning: no shell interpretation, timeouts on `execFileSync` to prevent hangs
-- Public attachment IDs; API key read from headers, not query params
-- Hub socket served at `/hub` path for reverse-proxy friendliness (TLS terminated at the proxy)
+- `Authorization: Bearer` header auth with a rotatable access key
+- Hardened spawning: no shell interpretation, timeouts on `execFileSync`
+- API keys read from headers, not query params
+- Hub socket served at `/hub` for reverse-proxy friendliness (TLS terminated at the proxy)
 
-### Packaging and deployment
+### Deployment
 
-- Reverse-proxy-friendly path strategy `<app>/api/...`
-- Unified port strategy ([doc 009](../../docs/009-port-strategy.md))
-- npm-published bin entry points: `naisys`, `naisys_hub`, `naisys_supervisor`, `naisys_erp`
-- Ngrok support (skip-browser-warning header + setup guide)
-- PWA manifest, favicons, Apple/Android icons
-- Shrinkwrap lockfile to prevent third-party upgrades from breaking the app
+- Reverse-proxy-friendly path strategy (`<app>/api/...`) and unified port strategy ([doc 009](../../docs/009-port-strategy.md))
+- npm bin entry points: `naisys`, `naisys-hub`, `naisys-supervisor`, `naisys-erp`
+- Ngrok-friendly (skip-browser-warning header)
 
 ## License
 

package/dist/naisysHub.js

@@ -104,6 +104,28 @@ export const startHub = async (startupType, startSupervisor, plugins, startupAge
         if (startupType === "hosted") {
             logService.disableConsole();
         }
+        // Hosted mode: parent process owns signal handling
+        if (startupType === "standalone") {
+            let shuttingDown = false;
+            const handleShutdown = async (signal) => {
+                if (shuttingDown) {
+                    console.log("[Hub] Force exit");
+                    process.exit(1);
+                }
+                shuttingDown = true;
+                logService.log(`[Hub] Shutting down (${signal})...`);
+                try {
+                    await io.close();
+                    await fastify.close();
+                }
+                catch (err) {
+                    console.error("[Hub] Error during shutdown:", err);
+                }
+                process.exit(0);
+            };
+            process.on("SIGTERM", () => void handleShutdown("SIGTERM"));
+            process.on("SIGINT", () => void handleShutdown("SIGINT"));
+        }
         return { serverPort };
     }
     catch (err) {

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
   "name": "@naisys/hub",
-  "version": "3.0.0-beta.35",
+  "version": "3.0.0-beta.36",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@naisys/hub",
-      "version": "3.0.0-beta.35",
+      "version": "3.0.0-beta.36",
       "dependencies": {
-        "@naisys/common": "3.0.0-beta.35",
-        "@naisys/common-node": "3.0.0-beta.35",
-        "@naisys/hub-database": "3.0.0-beta.35",
-        "@naisys/hub-protocol": "3.0.0-beta.35",
+        "@naisys/common": "3.0.0-beta.36",
+        "@naisys/common-node": "3.0.0-beta.36",
+        "@naisys/hub-database": "3.0.0-beta.36",
+        "@naisys/hub-protocol": "3.0.0-beta.36",
         "commander": "^14.0.3",
         "dotenv": "^17.3.1",
         "fastify": "^5.8.2",
@@ -24,7 +24,7 @@
         "node": ">=22.0.0"
       },
       "peerDependencies": {
-        "@naisys/supervisor": "3.0.0-beta.35"
+        "@naisys/supervisor": "3.0.0-beta.36"
       },
       "peerDependenciesMeta": {
         "@naisys/supervisor": {
@@ -189,32 +189,32 @@
       "license": "MIT"
     },
     "node_modules/@naisys/common": {
-      "version": "3.0.0-beta.35",
-      "resolved": "https://registry.npmjs.org/@naisys/common/-/common-3.0.0-beta.35.tgz",
-      "integrity": "sha512-8SvMZ/D8Ll+ZbnlhovI22Z3sTOhb3im3NLJda9VkBFDJQdfDqacV72YnHmNaG/39VthEzTSn0yrSirJ0O6cgHA==",
+      "version": "3.0.0-beta.36",
+      "resolved": "https://registry.npmjs.org/@naisys/common/-/common-3.0.0-beta.36.tgz",
+      "integrity": "sha512-a5EYqKvnL1Uy1pdslLZVMQERbo3ZtnMvhKa5B4GQJ/ziwM5zgMfbUFUEDniJRnta4dtIU5GxgzxBxmin+gMbhw==",
       "dependencies": {
         "semver": "^7.7.4",
         "zod": "^4.3.6"
       }
     },
     "node_modules/@naisys/common-node": {
-      "version": "3.0.0-beta.35",
-      "resolved": "https://registry.npmjs.org/@naisys/common-node/-/common-node-3.0.0-beta.35.tgz",
-      "integrity": "sha512-IpGH9HepjRATQ0AdQby5sd98keBH3TKcXRhRZpUH13j/vRLlbhZOZgzkqQz/55jrRbbSI84EVGZPxly1dUn/XQ==",
+      "version": "3.0.0-beta.36",
+      "resolved": "https://registry.npmjs.org/@naisys/common-node/-/common-node-3.0.0-beta.36.tgz",
+      "integrity": "sha512-pgzHJuh6OH6wiNU4PRV8sSNaBqWCYateD7+tWHnwvDwVOzwce8ttLNtsK+NQzwQqp+vjPAMpfJ9yMqoOttXgbA==",
       "dependencies": {
-        "@naisys/common": "3.0.0-beta.35",
+        "@naisys/common": "3.0.0-beta.36",
         "better-sqlite3": "^12.6.2",
         "js-yaml": "^4.1.1",
         "pino": "^10.3.1"
       }
     },
     "node_modules/@naisys/hub-database": {
-      "version": "3.0.0-beta.35",
-      "resolved": "https://registry.npmjs.org/@naisys/hub-database/-/hub-database-3.0.0-beta.35.tgz",
-      "integrity": "sha512-AE1wNMm/kMG/FL8VM8OWJiklA08DHi4iFf6HmZIshvK+br/Llt5h8yh3rSAn5gpYuGcstDjmDKsYm+v79QqtUw==",
+      "version": "3.0.0-beta.36",
+      "resolved": "https://registry.npmjs.org/@naisys/hub-database/-/hub-database-3.0.0-beta.36.tgz",
+      "integrity": "sha512-FiJJCaOARun5jbTwX2VwXgEy5xDqlMi7X1ZSpxSn0jMv3dzniupCYYAYyO4muwXdFLNO2vMnhUdmhK/m2k7ouw==",
       "dependencies": {
-        "@naisys/common": "3.0.0-beta.35",
-        "@naisys/common-node": "3.0.0-beta.35",
+        "@naisys/common": "3.0.0-beta.36",
+        "@naisys/common-node": "3.0.0-beta.36",
         "@prisma/adapter-better-sqlite3": "^7.5.0",
         "@prisma/client": "^7.5.0",
         "better-sqlite3": "^12.6.2",
@@ -222,11 +222,11 @@
       }
     },
     "node_modules/@naisys/hub-protocol": {
-      "version": "3.0.0-beta.35",
-      "resolved": "https://registry.npmjs.org/@naisys/hub-protocol/-/hub-protocol-3.0.0-beta.35.tgz",
-      "integrity": "sha512-cX03B8AsRB6Ln/Lm1z0iLiMRO0IKyrxmkpB0915lZ8mctACfgkSBLxYttxOKwV8Gwn7Jj5molPIYSVN6Wntc2Q==",
+      "version": "3.0.0-beta.36",
+      "resolved": "https://registry.npmjs.org/@naisys/hub-protocol/-/hub-protocol-3.0.0-beta.36.tgz",
+      "integrity": "sha512-JCxS982SjYUws3vg3O5XgoeoC0Pllhm7qLdqXTJpZY9v+SA5VGvu5/xvOURspNuIbpRayQkUx7cakTmQUQFKrw==",
       "dependencies": {
-        "@naisys/common": "3.0.0-beta.35",
+        "@naisys/common": "3.0.0-beta.36",
         "zod": "^4.3.6"
       }
     },
@@ -640,9 +640,9 @@
       }
     },
     "node_modules/ajv": {
-      "version": "8.18.0",
-      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz",
-      "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==",
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
       "license": "MIT",
       "dependencies": {
         "fast-deep-equal": "^3.1.3",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naisys/hub",
-  "version": "3.0.0-beta.35",
+  "version": "3.0.0-beta.36",
   "description": "NAISYS Hub - Adds persistence and multi-instance coordination to NAISYS",
   "type": "module",
   "main": "dist/naisysHub.js",
@@ -31,7 +31,7 @@
     "!dist/**/*.d.ts.map"
   ],
   "peerDependencies": {
-    "@naisys/supervisor": "3.0.0-beta.35"
+    "@naisys/supervisor": "3.0.0-beta.36"
   },
   "peerDependenciesMeta": {
     "@naisys/supervisor": {
@@ -39,10 +39,10 @@
     }
   },
   "dependencies": {
-    "@naisys/common": "3.0.0-beta.35",
-    "@naisys/common-node": "3.0.0-beta.35",
-    "@naisys/hub-database": "3.0.0-beta.35",
-    "@naisys/hub-protocol": "3.0.0-beta.35",
+    "@naisys/common": "3.0.0-beta.36",
+    "@naisys/common-node": "3.0.0-beta.36",
+    "@naisys/hub-database": "3.0.0-beta.36",
+    "@naisys/hub-protocol": "3.0.0-beta.36",
     "commander": "^14.0.3",
     "dotenv": "^17.3.1",
     "fastify": "^5.8.2",