@helyx/cli 0.3.4 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.4.1
+
+### Patch Changes
+
+- d25b465: Replace the user-specific shard diagnostic with a reusable, internal-guild-only
+  `/dev` command. Authorize Discord administrators or configured role IDs, expose
+  bounded shard, bot/module-version and process diagnostics, and keep the command
+  available for validating the unsharded compatibility baseline.
+- Updated dependencies [d25b465]
+  - @helyx/bot@0.4.1
+  - @helyx/config@0.4.1
+
+## 0.4.0
+
+### Minor Changes
+
+- 9cdb2ef: Add the opt-in shard supervisor/worker runtime, fenced coordination and routing,
+  durable command state, shard-aware guild ownership, and private operational
+  health while preserving unsharded defaults.
+
+### Patch Changes
+
+- Updated dependencies [9cdb2ef]
+  - @helyx/bot@0.4.0
+  - @helyx/config@0.4.0
+  - @helyx/database@0.4.0
+
 ## 0.3.4
 
 ### Patch Changes

package/dist/self-host/project-generator.js

@@ -227,6 +227,10 @@ export const selfHostEnvironmentContract = {
         value: "12345678901234567",
         optional: true,
     },
+    APPROVED_ROLES: {
+        value: "12345678901234567,12345678901234568",
+        optional: true,
+    },
     HELYX_MODULE_PACKAGES: {
         value: "",
         optional: true,
@@ -274,6 +278,34 @@ export const selfHostEnvironmentContract = {
         value: "12345678901234567",
         optional: true,
     },
+    HELYX_SHARD_MODE: { value: "off", optional: false },
+    HELYX_SHARD_COUNT: { value: "2", optional: true },
+    HELYX_SHARD_SCOPE: { value: "local", optional: true },
+    HELYX_SHARD_WORKERS_PER_REPLICA: { value: "2", optional: true },
+    HELYX_SHARD_REDIS_URL: {
+        value: "rediss://private-redis.example:6379",
+        optional: true,
+    },
+    HELYX_SHARD_REDIS_NAMESPACE: {
+        value: "helyx.self-host",
+        optional: true,
+    },
+    HELYX_SHARD_GENERATION: {
+        value: "local-20260728",
+        optional: true,
+    },
+    HELYX_SHARD_DATABASE_CONNECTION_BUDGET: {
+        value: "10",
+        optional: true,
+    },
+    HELYX_SHARD_SUPERVISOR_DATABASE_POOL_MAX: {
+        value: "2",
+        optional: true,
+    },
+    HELYX_SHARD_WORKER_DATABASE_POOL_MAX: {
+        value: "4",
+        optional: true,
+    },
     HELYX_CLOUD_AUDIT_RETENTION_DAYS: {
         value: "90",
         optional: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/cli",
-  "version": "0.3.4",
+  "version": "0.4.1",
   "description": "Command-line tools for running and generating self-hosted Helyx deployments.",
   "keywords": [
     "helyx",
@@ -52,9 +52,9 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@helyx/bot": "0.3.1",
-    "@helyx/config": "0.3.0",
-    "@helyx/database": "0.3.1",
+    "@helyx/bot": "0.4.1",
+    "@helyx/config": "0.4.1",
+    "@helyx/database": "0.4.0",
     "semver": "7.8.5",
     "zod": "4.4.3"
   },

package/templates/self-host/.env.example

@@ -27,6 +27,27 @@ LOG_LEVEL=info
 
 # Guild-scoped development commands only
 # DISCORD_INTERNAL_GUILD_ID=12345678901234567
+# APPROVED_ROLES=12345678901234567,12345678901234568
+
+# SHARDING: OFF BY DEFAULT
+
+# `off` is the compatible self-host default. Keep shard-only values commented
+# in this mode; an empty value is still rejected as configured. Advanced local
+# self-hosting may use `auto` to obtain Discord's recommendation under one
+# supervisor, or `fixed` with a deliberate total count. Local mode never needs
+# Redis. Coordinated multi-host self-hosting is outside the first release.
+HELYX_SHARD_MODE=off
+# HELYX_SHARD_SCOPE=local
+# HELYX_SHARD_COUNT=2
+# HELYX_SHARD_WORKERS_PER_REPLICA=2
+# HELYX_SHARD_REDIS_URL=rediss://private-redis.example:6379
+# HELYX_SHARD_REDIS_NAMESPACE=helyx.self-host
+# HELYX_SHARD_GENERATION=local-20260728
+# HELYX_SHARD_DATABASE_CONNECTION_BUDGET=10
+# HELYX_SHARD_SUPERVISOR_DATABASE_POOL_MAX=2
+# HELYX_SHARD_WORKER_DATABASE_POOL_MAX=4
+# Redis URL and namespace are intentionally unsupported for the first
+# self-hosted release: do not uncomment them for local auto or fixed mode.
 
 # ADVANCED INTEGRATIONS — EDIT ONLY WHEN NEEDED