@helyx/cli 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 1.2.0
+
+### Minor Changes
+
+- 00d33b3: Add the Testing Moderation and Auto Moderation modules, including accountable
+  staff cases, private violation threads, Discord-native rule ownership, bounded
+  rule imports, deterministic repeat-offender actions and shared Hosted and
+  Self-Hosted Enhanced matching. Add the private Helyx Ecko transport, operational
+  gate, aggregate health reporting, content-free scanner telemetry and portable
+  Self-Hosted composition while preserving Standard native enforcement as the
+  failure fallback.
+
+### Patch Changes
+
+- Updated dependencies [00d33b3]
+  - @helyx/bot@1.2.0
+  - @helyx/config@1.2.0
+  - @helyx/database@2.2.0
+
+## 1.1.2
+
+### Patch Changes
+
+- Refresh public package artifacts for the current dependency graph and ship the updated self-host catalogue.
+- Generate the explicit `self-hosted` runtime profile required by reviewed
+  feature-scoped adapters.
+
+## 1.1.1
+
+### Patch Changes
+
+- Refresh the embedded self-host catalogue for the Analytics 1.0.4
+  large-server report fix.
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -16,6 +16,10 @@ helyx self-host update --confirm
 
 `self-host init` retrieves the current reviewed catalogue from the fixed Helyx API endpoint, validates a downloaded build manifest against it, creates a new starter-project directory, pins the runtime and selected official modules, generates a lockfile with lifecycle scripts disabled, and writes checksums. The request has strict timeout, response-size, JSON-schema and official-package checks; no arbitrary catalogue URL or stale bundled fallback is accepted. Add `--install` only when the dependencies should also be installed locally. Unknown, unpublished, duplicated, stale or modified package selections fail closed.
 
+The generated environment identifies itself explicitly as `self-hosted` so
+deployment-neutral feature access can select embedded adapters without relying
+on billing or hosting-provider variables.
+
 Generated projects include `DOCUMENTATION.md`, which points to the
 version-matched public documentation bundled with the installed `@helyx/bot`
 package.

package/dist/self-host/project-generator.d.ts

@@ -16,7 +16,7 @@ export interface GeneratedSelfHostProject {
     files: string[];
 }
 export declare function generateSelfHostProject(options: GenerateSelfHostProjectOptions): Promise<GeneratedSelfHostProject>;
-type HostedOnlyBotEnvironment = "HELYX_SUPPORT_SERVICE_SECRET" | "HELYX_SUPPORT_STAFF_CHANNEL_ID" | "HELYX_VERIFICATION_ENABLED" | "HELYX_VERIFICATION_INSTALLATION_ID" | "HELYX_VERIFICATION_URL" | "HELYX_VERIFICATION_INTERNAL_SECRET" | "HELYX_VERIFICATION_SIGNING_PUBLIC_KEYS" | "STRIPE_ENVIRONMENT";
+type HostedOnlyBotEnvironment = "HELYX_SUPPORT_SERVICE_SECRET" | "HELYX_SUPPORT_STAFF_CHANNEL_ID" | "HELYX_VERIFICATION_ENABLED" | "HELYX_VERIFICATION_INSTALLATION_ID" | "HELYX_VERIFICATION_URL" | "HELYX_VERIFICATION_INTERNAL_SECRET" | "HELYX_VERIFICATION_SIGNING_PUBLIC_KEYS" | "HELYX_ECKO_TRANSPORT_SECRET" | "HELYX_ECKO_TRANSPORT_PREVIOUS_SECRET" | "STRIPE_ENVIRONMENT";
 type EnvironmentExample = Record<Exclude<keyof BotEnvironmentInput, HostedOnlyBotEnvironment>, {
     value: string;
     optional: boolean;

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

@@ -273,9 +273,22 @@ export const selfHostEnvironmentContract = {
         optional: false,
     },
     DATABASE_SSL: { value: "disable", optional: false },
+    HELYX_RUNTIME_PROFILE: { value: "self-hosted", optional: false },
+    HELYX_DEPLOYMENT_ENVIRONMENT: { value: "self-hosted", optional: false },
     DISCORD_TOKEN: { value: "replace-me", optional: false },
     DISCORD_CLIENT_ID: { value: "12345678901234567", optional: false },
     HELYX_MESSAGE_CONTENT_ENABLED: { value: "false", optional: false },
+    HELYX_AUTOMOD_EMBEDDED_WORKERS: { value: "1", optional: false },
+    HELYX_AUTOMOD_EMBEDDED_QUEUE_ITEMS: { value: "5000", optional: true },
+    HELYX_AUTOMOD_EMBEDDED_QUEUE_BYTES: { value: "67108864", optional: true },
+    HELYX_AUTOMOD_EMBEDDED_QUEUE_ITEMS_PER_GUILD: {
+        value: "100",
+        optional: true,
+    },
+    HELYX_AUTOMOD_EMBEDDED_REFRESH_SECONDS: {
+        value: "300",
+        optional: true,
+    },
     DISCORD_INTERNAL_GUILD_ID: {
         value: "12345678901234567",
         optional: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Command-line tools for running and generating self-hosted Helyx deployments.",
   "keywords": [
     "helyx",

package/self-host-catalogue.json

@@ -1,14 +1,14 @@
 {
   "schemaVersion": 2,
-  "catalogueVersion": 62,
+  "catalogueVersion": 67,
   "core": {
     "package": "@helyx/bot",
-    "version": "1.1.0",
+    "version": "1.2.0",
     "availability": "published"
   },
   "generator": {
     "package": "@helyx/cli",
-    "version": "1.1.0",
+    "version": "1.2.0",
     "command": "helyx",
     "availability": "published"
   },
@@ -16,7 +16,7 @@
     {
       "id": "helyx.feedback",
       "package": "@helyx/module-feedback",
-      "version": "1.2.1",
+      "version": "1.2.3",
       "name": "Feedback",
       "description": "Collects simple feedback from Discord server members.",
       "category": "Community",
@@ -34,7 +34,7 @@
     {
       "id": "helyx.welcome",
       "package": "@helyx/module-welcome",
-      "version": "1.2.3",
+      "version": "1.2.4",
       "name": "Welcome",
       "description": "Greets new members and can give them a starting role.",
       "category": "Community",
@@ -52,7 +52,7 @@
     {
       "id": "helyx.suggestions",
       "package": "@helyx/module-suggestions",
-      "version": "1.2.1",
+      "version": "1.2.2",
       "name": "Suggestions",
       "description": "Collects community ideas with configurable reaction or button voting.",
       "category": "Community",
@@ -70,7 +70,7 @@
     {
       "id": "helyx.polls",
       "package": "@helyx/module-polls",
-      "version": "1.1.1",
+      "version": "1.1.2",
       "name": "Polls",
       "description": "Run clear single or multiple-choice polls.",
       "category": "Community",
@@ -88,7 +88,7 @@
     {
       "id": "helyx.starboard",
       "package": "@helyx/module-starboard",
-      "version": "1.0.7",
+      "version": "1.0.8",
       "name": "Starboard",
       "description": "Highlight messages your community values.",
       "category": "Community",
@@ -106,7 +106,7 @@
     {
       "id": "helyx.levels",
       "package": "@helyx/module-levels",
-      "version": "1.1.2",
+      "version": "1.1.3",
       "name": "Levels",
       "description": "Optional participation levels and rewards.",
       "category": "Community",
@@ -214,43 +214,43 @@
     {
       "id": "helyx.moderation",
       "package": "@helyx/module-moderation",
-      "version": null,
+      "version": "1.0.1",
       "name": "Moderation",
-      "description": "Warnings, timeouts, kicks and bans with audit context.",
+      "description": "Apply accountable staff moderation actions and review durable cases.",
       "category": "Safety",
-      "availability": "planned",
-      "releaseStatus": "planned",
+      "availability": "unpublished",
+      "releaseStatus": "testing",
       "dependencies": [],
       "moduleKind": "customer_feature",
       "customerSelectable": true,
       "countsAsInstalledModule": true,
       "healthExposure": "direct",
-      "deploymentSupport": "unclassified",
-      "credentialRisk": "unclassified",
-      "deploymentReason": "No canonical v0.4 manifest exists; deployment and credential policy remain undecided."
+      "deploymentSupport": "both",
+      "credentialRisk": "none",
+      "deploymentReason": "Hosted and Self-Hosted installations use only Helyx runtime and Discord capabilities available inside the selected installation."
     },
     {
       "id": "helyx.automod",
       "package": "@helyx/module-automod",
-      "version": null,
-      "name": "Auto moderation",
-      "description": "Apply transparent rules to spam and unsafe content.",
+      "version": "1.0.1",
+      "name": "Auto Moderation",
+      "description": "Manage transparent Discord-native Auto Moderation rules and structural enforcement receipts.",
       "category": "Safety",
-      "availability": "planned",
-      "releaseStatus": "planned",
+      "availability": "unpublished",
+      "releaseStatus": "testing",
       "dependencies": [],
       "moduleKind": "customer_feature",
       "customerSelectable": true,
       "countsAsInstalledModule": true,
       "healthExposure": "direct",
-      "deploymentSupport": "unclassified",
-      "credentialRisk": "unclassified",
-      "deploymentReason": "No canonical v0.4 manifest exists; deployment and credential policy remain undecided."
+      "deploymentSupport": "both",
+      "credentialRisk": "none",
+      "deploymentReason": "Standard rules use Discord and Helyx runtime capabilities available in both Hosted and Self-Hosted installations."
     },
     {
       "id": "helyx.account-gate",
       "package": "@helyx/module-account-gate",
-      "version": "2.0.0",
+      "version": "2.0.2",
       "name": "Access Control",
       "description": "Require new members to complete configurable Discord interaction checks before gaining access.",
       "category": "Safety",
@@ -304,7 +304,7 @@
     {
       "id": "helyx.forms",
       "package": "@helyx/module-forms",
-      "version": "2.0.0",
+      "version": "2.0.1",
       "name": "Forms",
       "description": "Collect reusable structured responses through Discord modals.",
       "category": "Support & Staff",
@@ -322,7 +322,7 @@
     {
       "id": "helyx.faq",
       "package": "@helyx/module-faq",
-      "version": "1.0.6",
+      "version": "1.0.7",
       "name": "FAQ",
       "description": "Create reusable server answers with exact text triggers.",
       "category": "Support & Staff",
@@ -448,7 +448,7 @@
     {
       "id": "helyx.auto-message",
       "package": "@helyx/module-auto-message",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Auto-message",
       "description": "Publish rich Discord messages on bounded recurring schedules.",
       "category": "Auto Tools",
@@ -466,7 +466,7 @@
     {
       "id": "helyx.message-embedder",
       "package": "@helyx/module-message-embedder",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Message Embedder Builder",
       "description": "Create and maintain Helyx-owned rich Discord messages.",
       "category": "Automation",
@@ -502,7 +502,7 @@
     {
       "id": "helyx.afk",
       "package": "@helyx/module-afk",
-      "version": "2.0.0",
+      "version": "2.0.1",
       "name": "AFK",
       "description": "Set server-specific away statuses and bounded mention notices.",
       "category": "Automation",
@@ -520,7 +520,7 @@
     {
       "id": "helyx.reactionroles",
       "package": "@helyx/module-reactionroles",
-      "version": "1.0.18",
+      "version": "1.0.19",
       "name": "Reaction Roles",
       "description": "Let members select approved roles themselves.",
       "category": "Automation",
@@ -538,7 +538,7 @@
     {
       "id": "helyx.reminders",
       "package": "@helyx/module-reminders",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Reminders",
       "description": "Schedule bounded one-time personal and server reminders.",
       "category": "Automation",
@@ -574,7 +574,7 @@
     {
       "id": "helyx.scheduler",
       "package": "@helyx/module-scheduler",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Scheduler",
       "description": "Run reviewed message and role actions on bounded schedules.",
       "category": "Automation",
@@ -610,7 +610,7 @@
     {
       "id": "helyx.tags",
       "package": "@helyx/module-tags",
-      "version": "1.0.6",
+      "version": "1.0.7",
       "name": "Tags",
       "description": "Save and share short server snippets.",
       "category": "Automation",
@@ -628,7 +628,7 @@
     {
       "id": "helyx.sticky-messages",
       "package": "@helyx/module-sticky-messages",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Sticky Messages",
       "description": "Keep one rich message near the bottom of selected channels.",
       "category": "Automation",
@@ -646,7 +646,7 @@
     {
       "id": "helyx.role-expiry",
       "package": "@helyx/module-role-expiry",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Role Expiry",
       "description": "Grant and safely remove time-limited Discord roles.",
       "category": "Automation",
@@ -682,7 +682,7 @@
     {
       "id": "helyx.events",
       "package": "@helyx/module-events",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Events",
       "description": "Publish server events, collect RSVPs and record explicit attendance.",
       "category": "Engagement",
@@ -700,7 +700,7 @@
     {
       "id": "helyx.community-goals",
       "package": "@helyx/module-community-goals",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Community Goals",
       "description": "Run shared, measurable community challenges with reviewed member progress.",
       "category": "Community",
@@ -718,7 +718,7 @@
     {
       "id": "helyx.giveaways",
       "package": "@helyx/module-giveaways",
-      "version": "2.0.0",
+      "version": "2.0.1",
       "name": "Giveaways",
       "description": "Run auditable giveaways with eligibility rules.",
       "category": "Engagement",
@@ -736,7 +736,7 @@
     {
       "id": "helyx.birthdays",
       "package": "@helyx/module-birthdays",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Birthdays",
       "description": "Celebrate explicit member birthday opt-ins without storing birth years or ages.",
       "category": "Engagement",
@@ -754,7 +754,7 @@
     {
       "id": "helyx.counting",
       "package": "@helyx/module-counting",
-      "version": "1.0.8",
+      "version": "1.0.9",
       "name": "Counting",
       "description": "A focused, server-scoped Discord counting game.",
       "category": "Gaming",
@@ -772,7 +772,7 @@
     {
       "id": "helyx.trivia",
       "package": "@helyx/module-trivia",
-      "version": "1.1.1",
+      "version": "1.1.2",
       "name": "Trivia",
       "description": "Play private trivia rounds from a saved question catalogue.",
       "category": "Gaming",
@@ -880,7 +880,7 @@
     {
       "id": "helyx.achievements",
       "package": "@helyx/module-achievements",
-      "version": "2.0.0",
+      "version": "2.0.1",
       "name": "Achievements",
       "description": "Configurable member milestones, scores and optional rewards.",
       "category": "Gaming",
@@ -916,7 +916,7 @@
     {
       "id": "helyx.logging",
       "package": "@helyx/module-logging",
-      "version": "1.1.18",
+      "version": "1.1.19",
       "name": "Logging",
       "description": "Posts configurable activity records from enabled Helyx modules.",
       "category": "Insights",
@@ -934,7 +934,7 @@
     {
       "id": "helyx.analytics",
       "package": "@helyx/module-analytics",
-      "version": "1.0.3",
+      "version": "1.0.6",
       "name": "Analytics",
       "description": "Generate private, bounded analytics reports from current Discord metadata.",
       "category": "Insights",
@@ -952,7 +952,7 @@
     {
       "id": "helyx.invite-tracking",
       "package": "@helyx/module-invite-tracking",
-      "version": "1.0.2",
+      "version": "1.0.3",
       "name": "Invite Tracking",
       "description": "Attribute observed member joins through bounded Discord invite-use snapshots.",
       "category": "Insights",
@@ -970,7 +970,7 @@
     {
       "id": "helyx.health",
       "package": "@helyx/module-health",
-      "version": "1.0.7",
+      "version": "1.0.8",
       "name": "Server Health",
       "description": "Scan your Discord server for configuration, safety and capacity issues.",
       "category": "Insights",
@@ -1060,7 +1060,7 @@
     {
       "id": "helyx.nexus-core",
       "package": "@helyx/module-nexus-core",
-      "version": "2.0.0",
+      "version": "2.0.1",
       "name": "Nexus Core",
       "description": "Provides the shared Nexus balance, ledger, terminology and command namespace.",
       "category": "Gaming",
@@ -1078,7 +1078,7 @@
     {
       "id": "helyx.nexus-rewards",
       "package": "@helyx/module-nexus-rewards",
-      "version": "1.0.7",
+      "version": "1.0.8",
       "name": "Nexus Rewards",
       "description": "Configure Daily Claim and approved ways members earn Nexus units.",
       "category": "Community",
@@ -1101,7 +1101,7 @@
     {
       "id": "helyx.nexus-economy",
       "package": "@helyx/module-nexus-economy",
-      "version": "1.0.8",
+      "version": "1.0.9",
       "name": "Nexus Economy",
       "description": "Run a Nexus Exchange with server rewards and member inventory.",
       "category": "Gaming",

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

@@ -1,11 +1,23 @@
 # REQUIRED — EDIT THESE VALUES
 
+HELYX_RUNTIME_PROFILE=self-hosted
+HELYX_DEPLOYMENT_ENVIRONMENT=self-hosted
+
 # Discord
 DISCORD_TOKEN=replace-me
 DISCORD_CLIENT_ID=12345678901234567
 # Explicit privileged gateway opt-in. Keep false unless a reviewed loaded module
 # requires message content and it is enabled in the Discord developer portal.
 HELYX_MESSAGE_CONTENT_ENABLED=false
+# Enhanced Auto Moderation stays inside this bot process. One worker is the
+# recommended default; increase only after measuring local CPU and memory.
+HELYX_AUTOMOD_EMBEDDED_WORKERS=1
+# Optional conservative queue overrides (hard ceilings: 5000 items, 64 MiB,
+# 100 items per server). Defaults are used when these remain commented.
+# HELYX_AUTOMOD_EMBEDDED_QUEUE_ITEMS=5000
+# HELYX_AUTOMOD_EMBEDDED_QUEUE_BYTES=67108864
+# HELYX_AUTOMOD_EMBEDDED_QUEUE_ITEMS_PER_GUILD=100
+# HELYX_AUTOMOD_EMBEDDED_REFRESH_SECONDS=300
 # Enable only when member inspection modules are loaded and the Discord Server
 # Members Intent is enabled in the Discord developer portal.
 HELYX_GUILD_MEMBERS_ENABLED=false

package/templates/self-host/README.md

@@ -58,6 +58,15 @@ If a provider cannot run `npm ci`, execute `npm start`, or connect to PostgreSQL
 2. Copy the application ID into `DISCORD_CLIENT_ID`. Generate a bot token and place it directly in `.env` or the host's variables panel; never place that token in Discord, Git, screenshots or support messages.
 3. Install the bot using both the `bot` and `applications.commands` scopes. Review the permissions required by your selected modules and grant only what you intend; administrator access is convenient but not required by Helyx core.
 
+If Auto Moderation Enhanced mode is selected, also enable the privileged Message
+Content intent in the developer portal and set
+`HELYX_MESSAGE_CONTENT_ENABLED=true`. Enhanced scanning uses bounded worker
+threads inside this same bot and the same PostgreSQL database. Keep the default
+one worker until host CPU and memory measurements justify a value from two to
+four. No separate Ecko service, Redis instance, public endpoint or second
+database is required; unhealthy workers fall back to Discord-native Standard
+coverage.
+
 `npm start` validates the environment, connects to PostgreSQL, applies core and selected-module migrations safely, validates installed modules, synchronises Discord commands and then reports readiness. Do not run a separate migration command before every start. `npm run migrate` is available when you deliberately need to apply core migrations without starting Discord.
 
 `npm run doctor` validates the environment, PostgreSQL connection, existing migration history and selected packages without signing in to Discord or modifying the database. On a new database it reports migrations that `npm start` will apply automatically.