@helyx/module-automod 1.0.1

package/manifest.json

@@ -0,0 +1,1601 @@
+{
+  "manifestVersion": "0.5",
+  "releaseStatus": "live",
+  "deploymentSupport": "both",
+  "credentialRisk": "none",
+  "deploymentReason": "Standard rules use Discord and Helyx runtime capabilities available in both Hosted and Self-Hosted installations.",
+  "tier": "free",
+  "moduleKind": "customer_feature",
+  "customerSelectable": true,
+  "countsAsInstalledModule": true,
+  "healthExposure": "direct",
+  "id": "helyx.automod",
+  "name": "Auto Moderation",
+  "version": "1.0.1",
+  "description": "Manage transparent Discord-native Auto Moderation rules and structural enforcement receipts.",
+  "entry": "./dist/index.js",
+  "framework": "^0.1.0",
+  "dependencies": [],
+  "permissions": ["MANAGE_GUILD", "MODERATE_MEMBERS"],
+  "features": [
+    {
+      "id": "automod.enhanced-scanning",
+      "hostedAccess": "helyx.premium",
+      "selfHostedAccess": "included",
+      "requiredDiscordCapabilities": ["message-content"],
+      "adapterRisk": {
+        "hosted": "high",
+        "selfHosted": "none",
+        "reason": "Hosted Enhanced scanning uses Ecko while Self-Hosted Enhanced scanning remains inside the existing bot process."
+      }
+    }
+  ],
+  "permissionOperations": [
+    {
+      "id": "automod.rules.read",
+      "label": "Read Auto Moderation rules",
+      "description": "List and inspect Auto Moderation rule definitions.",
+      "defaultPreset": "administrators"
+    },
+    {
+      "id": "automod.rules.manage",
+      "label": "Manage Auto Moderation rules",
+      "description": "Review rule imports and delete unmapped unpublished Auto Moderation rules.",
+      "defaultPreset": "administrators"
+    },
+    {
+      "id": "automod.rules.publish",
+      "label": "Save or disable Auto Moderation rules",
+      "description": "Validate and apply new or edited Helyx-owned Discord rules with Save, or disable their protection.",
+      "defaultPreset": "administrators"
+    },
+    {
+      "id": "automod.rules.reconcile",
+      "label": "Reconcile Auto Moderation rules",
+      "description": "Adopt, restore or clean up a mapped Helyx-owned Discord rule.",
+      "defaultPreset": "administrators"
+    },
+    {
+      "id": "automod.activity.read",
+      "label": "Read Auto Moderation activity",
+      "description": "Read content-free native Auto Moderation activity receipts.",
+      "defaultPreset": "administrators"
+    },
+    {
+      "id": "automod.settings.manage",
+      "label": "Manage Auto Moderation settings",
+      "description": "Change native defaults, exemptions and repeat-offender settings.",
+      "defaultPreset": "administrators"
+    }
+  ],
+  "privacy": {
+    "containsPersonalData": true,
+    "providerVersion": 1,
+    "collections": [
+      {
+        "name": "rules",
+        "createdAtField": "created_at",
+        "subjectFields": [
+          {
+            "field": "created_by_user_id",
+            "role": "rule-creator",
+            "erasure": "set-null"
+          },
+          {
+            "field": "updated_by_user_id",
+            "role": "rule-updater",
+            "erasure": "set-null"
+          }
+        ],
+        "subjectRelationships": [],
+        "contentFields": [
+          {
+            "field": "document_json",
+            "mayIdentifySubject": true,
+            "erasure": "manual-review"
+          }
+        ]
+      },
+      {
+        "name": "action_receipts",
+        "createdAtField": "created_at",
+        "subjectFields": [
+          {
+            "field": "subject_user_id",
+            "role": "detected-member",
+            "erasure": "set-null"
+          }
+        ],
+        "subjectRelationships": [],
+        "contentFields": [
+          {
+            "field": "channel_id",
+            "mayIdentifySubject": true,
+            "erasure": "manual-review"
+          },
+          {
+            "field": "message_id",
+            "mayIdentifySubject": true,
+            "erasure": "manual-review"
+          },
+          {
+            "field": "alert_system_message_id",
+            "mayIdentifySubject": true,
+            "erasure": "manual-review"
+          }
+        ]
+      },
+      {
+        "name": "enforcement_claims",
+        "createdAtField": "created_at",
+        "subjectFields": [
+          {
+            "field": "subject_user_id",
+            "role": "enforced-member",
+            "erasure": "set-null"
+          }
+        ],
+        "subjectRelationships": [],
+        "contentFields": [
+          {
+            "field": "request_fingerprint",
+            "mayIdentifySubject": true,
+            "erasure": "manual-review"
+          },
+          {
+            "field": "channel_id",
+            "mayIdentifySubject": true,
+            "erasure": "manual-review"
+          },
+          {
+            "field": "message_id",
+            "mayIdentifySubject": true,
+            "erasure": "manual-review"
+          }
+        ]
+      }
+    ]
+  },
+  "dashboard": {
+    "category": "safety",
+    "icon": "shield",
+    "settingsMutationPermissionId": "automod.settings.manage",
+    "settingsPreview": {
+      "permissionId": "automod.settings.manage",
+      "featureId": "automod.enhanced-scanning",
+      "label": "Preview Enhanced detection",
+      "description": "Test unsaved confidence settings against fictional content without sending it to Discord.",
+      "inputs": [
+        {
+          "key": "content",
+          "type": "string",
+          "label": "Fictional content",
+          "description": "A fictional message tested in memory against currently published rules.",
+          "required": true,
+          "supportVisibility": "hidden",
+          "minLength": 1,
+          "maxLength": 2000,
+          "multiline": true
+        }
+      ]
+    },
+    "settings": [
+      {
+        "key": "configuredMode",
+        "type": "select",
+        "label": "Detection mode",
+        "description": "Use Discord-native Standard rules or add feature-scoped Enhanced matching.",
+        "group": "Mode",
+        "required": true,
+        "supportVisibility": "value",
+        "options": [
+          {
+            "value": "standard",
+            "label": "Standard"
+          },
+          {
+            "value": "enhanced",
+            "label": "Enhanced",
+            "featureId": "automod.enhanced-scanning",
+            "requiredDiscordCapability": "message-content"
+          }
+        ],
+        "default": "standard"
+      },
+      {
+        "key": "enhancedSensitivityProfile",
+        "type": "select",
+        "label": "Detection sensitivity",
+        "description": "Choose the Enhanced transformed-match sensitivity profile.",
+        "group": "Enhanced scanning",
+        "required": true,
+        "supportVisibility": "value",
+        "featureId": "automod.enhanced-scanning",
+        "options": [
+          {
+            "value": "strict",
+            "label": "Strict (90)"
+          },
+          {
+            "value": "balanced",
+            "label": "Balanced (80)"
+          },
+          {
+            "value": "sensitive",
+            "label": "Sensitive (70)"
+          },
+          {
+            "value": "custom",
+            "label": "Custom"
+          }
+        ],
+        "default": "balanced"
+      },
+      {
+        "key": "enhancedMinimumConfidence",
+        "type": "integer",
+        "label": "Minimum match confidence",
+        "description": "Lowest versioned matching score accepted in Custom mode; it is not a probability of harm.",
+        "group": "Enhanced scanning",
+        "required": true,
+        "supportVisibility": "value",
+        "featureId": "automod.enhanced-scanning",
+        "minimum": 60,
+        "maximum": 95,
+        "default": 80,
+        "display": "range",
+        "step": 1,
+        "visibleWhen": {
+          "field": "enhancedSensitivityProfile",
+          "equals": "custom"
+        }
+      },
+      {
+        "key": "enhancedCategoryOverridesEnabled",
+        "type": "boolean",
+        "label": "Category confidence overrides",
+        "description": "Use separate Enhanced confidence thresholds for Low, Medium, High and Critical.",
+        "group": "Enhanced scanning",
+        "required": true,
+        "supportVisibility": "value",
+        "featureId": "automod.enhanced-scanning",
+        "default": false
+      },
+      {
+        "key": "enhancedLowMinimumConfidence",
+        "type": "integer",
+        "label": "Low confidence",
+        "description": "Minimum transformed-match confidence for Low rules.",
+        "group": "Enhanced category thresholds",
+        "required": true,
+        "supportVisibility": "value",
+        "featureId": "automod.enhanced-scanning",
+        "minimum": 60,
+        "maximum": 95,
+        "default": 80,
+        "display": "range",
+        "step": 1,
+        "visibleWhen": {
+          "field": "enhancedCategoryOverridesEnabled",
+          "equals": true
+        }
+      },
+      {
+        "key": "enhancedMediumMinimumConfidence",
+        "type": "integer",
+        "label": "Medium confidence",
+        "description": "Minimum transformed-match confidence for Medium rules.",
+        "group": "Enhanced category thresholds",
+        "required": true,
+        "supportVisibility": "value",
+        "featureId": "automod.enhanced-scanning",
+        "minimum": 60,
+        "maximum": 95,
+        "default": 80,
+        "display": "range",
+        "step": 1,
+        "visibleWhen": {
+          "field": "enhancedCategoryOverridesEnabled",
+          "equals": true
+        }
+      },
+      {
+        "key": "enhancedHighMinimumConfidence",
+        "type": "integer",
+        "label": "High confidence",
+        "description": "Minimum transformed-match confidence for High rules.",
+        "group": "Enhanced category thresholds",
+        "required": true,
+        "supportVisibility": "value",
+        "featureId": "automod.enhanced-scanning",
+        "minimum": 60,
+        "maximum": 95,
+        "default": 80,
+        "display": "range",
+        "step": 1,
+        "visibleWhen": {
+          "field": "enhancedCategoryOverridesEnabled",
+          "equals": true
+        }
+      },
+      {
+        "key": "enhancedCriticalMinimumConfidence",
+        "type": "integer",
+        "label": "Critical confidence",
+        "description": "Minimum transformed-match confidence for Critical rules.",
+        "group": "Enhanced category thresholds",
+        "required": true,
+        "supportVisibility": "value",
+        "featureId": "automod.enhanced-scanning",
+        "minimum": 60,
+        "maximum": 95,
+        "default": 80,
+        "display": "range",
+        "step": 1,
+        "visibleWhen": {
+          "field": "enhancedCategoryOverridesEnabled",
+          "equals": true
+        }
+      },
+      {
+        "key": "presetRuleEnabled",
+        "type": "boolean",
+        "label": "Allow preset rule configuration",
+        "description": "Allow Helyx-managed rules using Discord's preset profanity, sexual-content and slur filters.",
+        "group": "Native rules",
+        "required": true,
+        "supportVisibility": "value",
+        "default": false
+      },
+      {
+        "key": "genericSpamRuleEnabled",
+        "type": "boolean",
+        "label": "Allow generic spam rule configuration",
+        "description": "Allow Helyx-managed rules using Discord's automatic spam detection.",
+        "group": "Native rules",
+        "required": true,
+        "supportVisibility": "value",
+        "default": false
+      },
+      {
+        "key": "mentionSpamRuleEnabled",
+        "type": "boolean",
+        "label": "Allow mention spam rule configuration",
+        "description": "Allow Helyx-managed rules limiting mentions and using Discord's mention-raid protection.",
+        "group": "Native rules",
+        "required": true,
+        "supportVisibility": "value",
+        "default": false
+      },
+      {
+        "key": "defaultNativeAlertChannelId",
+        "type": "discord-channel",
+        "label": "Default Discord alert channel",
+        "description": "Default staff channel for native alerts; Discord may copy triggering content there.",
+        "group": "Native defaults",
+        "required": false,
+        "supportVisibility": "value",
+        "channelTypes": ["guild_text", "guild_announcement"],
+        "multiple": false
+      },
+      {
+        "key": "defaultExemptRoleIds",
+        "type": "discord-role",
+        "label": "Globally ignored roles",
+        "description": "Roles exempt from every Helyx-owned Auto Moderation rule.",
+        "group": "Global exclusions",
+        "required": false,
+        "supportVisibility": "value",
+        "multiple": true,
+        "minItems": 0,
+        "maxItems": 20
+      },
+      {
+        "key": "defaultExemptChannelIds",
+        "type": "discord-channel",
+        "label": "Globally ignored channels",
+        "description": "Channels exempt from every Helyx-owned Auto Moderation rule.",
+        "group": "Global exclusions",
+        "required": false,
+        "supportVisibility": "value",
+        "channelTypes": [
+          "guild_text",
+          "guild_announcement",
+          "guild_forum",
+          "guild_media"
+        ],
+        "multiple": true,
+        "minItems": 0,
+        "maxItems": 50
+      },
+      {
+        "key": "repeatOffenderWindowDays",
+        "type": "integer",
+        "label": "Repeat-offender window",
+        "description": "Rolling number of days used for first, second and third-or-later offence selection.",
+        "group": "Repeat offenders",
+        "required": true,
+        "supportVisibility": "value",
+        "minimum": 1,
+        "maximum": 365,
+        "default": 30
+      }
+    ],
+    "resources": [
+      {
+        "id": "automod-rules",
+        "name": "Rules",
+        "singularName": "Rule",
+        "description": "Save validated rules to create or update their Helyx-owned Discord Auto Moderation settings immediately.",
+        "operations": [
+          "list",
+          "read",
+          "preview",
+          "import",
+          "create",
+          "update",
+          "delete",
+          "action"
+        ],
+        "creationIntents": ["publish"],
+        "publicationMode": "validate_on_publish",
+        "permissions": {
+          "list": "automod.rules.read",
+          "read": "automod.rules.read",
+          "preview": "automod.rules.read",
+          "import": "automod.rules.manage",
+          "create": "automod.rules.publish",
+          "update": "automod.rules.publish",
+          "delete": "automod.rules.manage"
+        },
+        "tablePresentation": {
+          "primaryColumnLabel": "Rule name",
+          "showStatus": true,
+          "showUpdated": true,
+          "openAction": "primary",
+          "responsive": "stacked"
+        },
+        "columns": [
+          {
+            "key": "filter",
+            "label": "Filter",
+            "format": "text"
+          },
+          {
+            "key": "action",
+            "label": "Action",
+            "format": "text"
+          },
+          {
+            "key": "moderationThread",
+            "label": "Moderation thread",
+            "format": "text"
+          },
+          {
+            "key": "ignoredRoles",
+            "label": "Ignored roles",
+            "format": "role_list"
+          },
+          {
+            "key": "repeatOffender",
+            "label": "Repeat offender",
+            "format": "text"
+          }
+        ],
+        "fields": [
+          {
+            "key": "name",
+            "type": "string",
+            "label": "Rule name",
+            "description": "Unique logical rule name in this server.",
+            "required": true,
+            "supportVisibility": "value",
+            "minLength": 1,
+            "maxLength": 80
+          },
+          {
+            "key": "category",
+            "type": "select",
+            "label": "Category",
+            "description": "Low, Medium, High or Critical classification.",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "low",
+                "label": "Low"
+              },
+              {
+                "value": "medium",
+                "label": "Medium"
+              },
+              {
+                "value": "high",
+                "label": "High"
+              },
+              {
+                "value": "critical",
+                "label": "Critical"
+              }
+            ],
+            "default": "medium"
+          },
+          {
+            "key": "ruleKind",
+            "type": "select",
+            "label": "Filter type",
+            "description": "Discord-native trigger used by this rule.",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "keyword",
+                "label": "Keywords and phrases"
+              },
+              {
+                "value": "keyword_preset",
+                "label": "Discord preset"
+              },
+              {
+                "value": "spam",
+                "label": "Generic spam"
+              },
+              {
+                "value": "mention_spam",
+                "label": "Mention spam"
+              }
+            ],
+            "default": "keyword"
+          },
+          {
+            "key": "keywordFilter",
+            "type": "string",
+            "label": "Keywords and phrases",
+            "description": "Comma or newline-separated Discord keyword, phrase and wildcard entries.",
+            "required": false,
+            "supportVisibility": "hidden",
+            "minLength": 0,
+            "maxLength": 4000,
+            "multiline": true,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "keyword"
+            }
+          },
+          {
+            "key": "regexPatterns",
+            "type": "string",
+            "label": "Safe regex patterns",
+            "description": "Newline-separated Discord-compatible Rust regex patterns.",
+            "required": false,
+            "supportVisibility": "hidden",
+            "minLength": 0,
+            "maxLength": 4000,
+            "multiline": true,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "keyword"
+            }
+          },
+          {
+            "key": "allowList",
+            "type": "string",
+            "label": "Allow list",
+            "description": "Comma or newline-separated entries excluded from keyword or preset matching.",
+            "required": false,
+            "supportVisibility": "hidden",
+            "minLength": 0,
+            "maxLength": 4000,
+            "multiline": true,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "oneOf": ["keyword", "keyword_preset"]
+            }
+          },
+          {
+            "key": "enhancedNormalisedMatching",
+            "type": "boolean",
+            "label": "Enhanced normalised matching",
+            "description": "Match reviewed Unicode, visual substitution and separator variants for this bounded term group.",
+            "required": true,
+            "supportVisibility": "value",
+            "featureId": "automod.enhanced-scanning",
+            "default": true,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "keyword"
+            }
+          },
+          {
+            "key": "enhancedFuzzyMatching",
+            "type": "boolean",
+            "label": "Enhanced fuzzy matching",
+            "description": "Opt this rule's keyword group into bounded approximate matching. Short terms remain protected.",
+            "required": true,
+            "supportVisibility": "value",
+            "featureId": "automod.enhanced-scanning",
+            "default": false,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "keyword"
+            }
+          },
+          {
+            "key": "presetProfanity",
+            "type": "boolean",
+            "label": "Profanity preset",
+            "description": "Include Discord's profanity preset.",
+            "required": true,
+            "supportVisibility": "value",
+            "default": false,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "keyword_preset"
+            }
+          },
+          {
+            "key": "presetSexualContent",
+            "type": "boolean",
+            "label": "Sexual-content preset",
+            "description": "Include Discord's sexual-content preset.",
+            "required": true,
+            "supportVisibility": "value",
+            "default": false,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "keyword_preset"
+            }
+          },
+          {
+            "key": "presetSlurs",
+            "type": "boolean",
+            "label": "Slurs preset",
+            "description": "Include Discord's slurs preset.",
+            "required": true,
+            "supportVisibility": "value",
+            "default": false,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "keyword_preset"
+            }
+          },
+          {
+            "key": "mentionTotalLimit",
+            "type": "integer",
+            "label": "Mention limit",
+            "description": "Maximum mentions allowed in one message.",
+            "required": true,
+            "supportVisibility": "value",
+            "minimum": 1,
+            "maximum": 50,
+            "default": 5,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "mention_spam"
+            }
+          },
+          {
+            "key": "mentionRaidProtectionEnabled",
+            "type": "boolean",
+            "label": "Mention raid protection",
+            "description": "Use Discord's mention raid protection.",
+            "required": true,
+            "supportVisibility": "value",
+            "default": false,
+            "visibleWhen": {
+              "field": "ruleKind",
+              "equals": "mention_spam"
+            }
+          },
+          {
+            "key": "blockMessage",
+            "type": "boolean",
+            "label": "Block message",
+            "description": "Block native matches in Discord and remove posted Enhanced matches after detection.",
+            "required": true,
+            "supportVisibility": "value",
+            "default": true
+          },
+          {
+            "key": "blockExplanation",
+            "type": "string",
+            "label": "Block explanation",
+            "description": "Optional explanation Discord shows after blocking.",
+            "required": false,
+            "supportVisibility": "value",
+            "minLength": 0,
+            "maxLength": 150
+          },
+          {
+            "key": "alertChannelId",
+            "type": "discord-channel",
+            "label": "Discord alert channel",
+            "description": "Optional alert channel; Discord may copy triggering content there.",
+            "required": false,
+            "supportVisibility": "value",
+            "channelTypes": ["guild_text", "guild_announcement"],
+            "multiple": false
+          },
+          {
+            "key": "nativeTimeoutSeconds",
+            "type": "select",
+            "label": "Discord mute",
+            "description": "Optional Discord-native timeout applied before Helyx follow-up.",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "0",
+                "label": "Off"
+              },
+              {
+                "value": "60",
+                "label": "60 seconds"
+              },
+              {
+                "value": "300",
+                "label": "5 minutes"
+              },
+              {
+                "value": "600",
+                "label": "10 minutes"
+              },
+              {
+                "value": "3600",
+                "label": "1 hour"
+              },
+              {
+                "value": "86400",
+                "label": "1 day"
+              },
+              {
+                "value": "604800",
+                "label": "1 week"
+              }
+            ],
+            "default": "0",
+            "visibleWhen": {
+              "field": "ruleKind",
+              "oneOf": ["keyword", "mention_spam"]
+            }
+          },
+          {
+            "key": "ignoredRoleIds",
+            "type": "discord-role",
+            "label": "Ignored roles",
+            "description": "Roles ignored in addition to the global list.",
+            "required": false,
+            "supportVisibility": "value",
+            "multiple": true,
+            "minItems": 0,
+            "maxItems": 20
+          },
+          {
+            "key": "ignoredChannelIds",
+            "type": "discord-channel",
+            "label": "Ignored channels",
+            "description": "Channels ignored in addition to the global list.",
+            "required": false,
+            "supportVisibility": "value",
+            "channelTypes": [
+              "guild_text",
+              "guild_announcement",
+              "guild_forum",
+              "guild_media"
+            ],
+            "multiple": true,
+            "minItems": 0,
+            "maxItems": 50
+          },
+          {
+            "key": "openViolationThread",
+            "type": "boolean",
+            "label": "Moderation thread",
+            "description": "Ask the optional Moderation module to open a user-visible violation thread.",
+            "required": true,
+            "supportVisibility": "value",
+            "default": false
+          },
+          {
+            "key": "firstAction",
+            "type": "select",
+            "label": "First offence",
+            "description": "Action selected for the first confirmed offence.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "case_only",
+                "label": "Case only"
+              },
+              {
+                "value": "delete_message",
+                "label": "Delete message"
+              },
+              {
+                "value": "warn",
+                "label": "Warn"
+              },
+              {
+                "value": "timeout",
+                "label": "Mute"
+              },
+              {
+                "value": "kick",
+                "label": "Kick"
+              },
+              {
+                "value": "ban",
+                "label": "Ban"
+              },
+              {
+                "value": "demote",
+                "label": "Demote"
+              }
+            ],
+            "default": "case_only"
+          },
+          {
+            "key": "secondAction",
+            "type": "select",
+            "label": "Second offence",
+            "description": "Action selected for the second confirmed offence.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "case_only",
+                "label": "Case only"
+              },
+              {
+                "value": "delete_message",
+                "label": "Delete message"
+              },
+              {
+                "value": "warn",
+                "label": "Warn"
+              },
+              {
+                "value": "timeout",
+                "label": "Mute"
+              },
+              {
+                "value": "kick",
+                "label": "Kick"
+              },
+              {
+                "value": "ban",
+                "label": "Ban"
+              },
+              {
+                "value": "demote",
+                "label": "Demote"
+              }
+            ],
+            "default": "case_only"
+          },
+          {
+            "key": "thirdAction",
+            "type": "select",
+            "label": "Third offence and later",
+            "description": "Action selected for every third-or-later confirmed offence.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "case_only",
+                "label": "Case only"
+              },
+              {
+                "value": "delete_message",
+                "label": "Delete message"
+              },
+              {
+                "value": "warn",
+                "label": "Warn"
+              },
+              {
+                "value": "timeout",
+                "label": "Mute"
+              },
+              {
+                "value": "kick",
+                "label": "Kick"
+              },
+              {
+                "value": "ban",
+                "label": "Ban"
+              },
+              {
+                "value": "demote",
+                "label": "Demote"
+              }
+            ],
+            "default": "case_only"
+          },
+          {
+            "key": "firstTimeoutSeconds",
+            "type": "select",
+            "label": "First-offence mute",
+            "description": "Mute duration when the first action is Mute.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "60",
+                "label": "60 seconds"
+              },
+              {
+                "value": "300",
+                "label": "5 minutes"
+              },
+              {
+                "value": "600",
+                "label": "10 minutes"
+              },
+              {
+                "value": "3600",
+                "label": "1 hour"
+              },
+              {
+                "value": "86400",
+                "label": "1 day"
+              },
+              {
+                "value": "604800",
+                "label": "1 week"
+              }
+            ],
+            "default": "300",
+            "visibleWhen": {
+              "field": "firstAction",
+              "equals": "timeout"
+            }
+          },
+          {
+            "key": "secondTimeoutSeconds",
+            "type": "select",
+            "label": "Second-offence mute",
+            "description": "Mute duration when the second action is Mute.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "60",
+                "label": "60 seconds"
+              },
+              {
+                "value": "300",
+                "label": "5 minutes"
+              },
+              {
+                "value": "600",
+                "label": "10 minutes"
+              },
+              {
+                "value": "3600",
+                "label": "1 hour"
+              },
+              {
+                "value": "86400",
+                "label": "1 day"
+              },
+              {
+                "value": "604800",
+                "label": "1 week"
+              }
+            ],
+            "default": "300",
+            "visibleWhen": {
+              "field": "secondAction",
+              "equals": "timeout"
+            }
+          },
+          {
+            "key": "thirdTimeoutSeconds",
+            "type": "select",
+            "label": "Third-offence mute",
+            "description": "Mute duration when the third action is Mute.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "60",
+                "label": "60 seconds"
+              },
+              {
+                "value": "300",
+                "label": "5 minutes"
+              },
+              {
+                "value": "600",
+                "label": "10 minutes"
+              },
+              {
+                "value": "3600",
+                "label": "1 hour"
+              },
+              {
+                "value": "86400",
+                "label": "1 day"
+              },
+              {
+                "value": "604800",
+                "label": "1 week"
+              }
+            ],
+            "default": "300",
+            "visibleWhen": {
+              "field": "thirdAction",
+              "equals": "timeout"
+            }
+          },
+          {
+            "key": "firstBanDeleteMessageSeconds",
+            "type": "select",
+            "label": "First-offence ban deletion",
+            "description": "Message history removed when the first action is Ban.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "0",
+                "label": "None"
+              },
+              {
+                "value": "3600",
+                "label": "1 hour"
+              },
+              {
+                "value": "21600",
+                "label": "6 hours"
+              },
+              {
+                "value": "86400",
+                "label": "1 day"
+              },
+              {
+                "value": "259200",
+                "label": "3 days"
+              },
+              {
+                "value": "604800",
+                "label": "1 week"
+              }
+            ],
+            "default": "0",
+            "visibleWhen": {
+              "field": "firstAction",
+              "equals": "ban"
+            }
+          },
+          {
+            "key": "secondBanDeleteMessageSeconds",
+            "type": "select",
+            "label": "Second-offence ban deletion",
+            "description": "Message history removed when the second action is Ban.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "0",
+                "label": "None"
+              },
+              {
+                "value": "3600",
+                "label": "1 hour"
+              },
+              {
+                "value": "21600",
+                "label": "6 hours"
+              },
+              {
+                "value": "86400",
+                "label": "1 day"
+              },
+              {
+                "value": "259200",
+                "label": "3 days"
+              },
+              {
+                "value": "604800",
+                "label": "1 week"
+              }
+            ],
+            "default": "0",
+            "visibleWhen": {
+              "field": "secondAction",
+              "equals": "ban"
+            }
+          },
+          {
+            "key": "thirdBanDeleteMessageSeconds",
+            "type": "select",
+            "label": "Third-offence ban deletion",
+            "description": "Message history removed when the third action is Ban.",
+            "group": "Repeat offender",
+            "required": true,
+            "supportVisibility": "value",
+            "options": [
+              {
+                "value": "0",
+                "label": "None"
+              },
+              {
+                "value": "3600",
+                "label": "1 hour"
+              },
+              {
+                "value": "21600",
+                "label": "6 hours"
+              },
+              {
+                "value": "86400",
+                "label": "1 day"
+              },
+              {
+                "value": "259200",
+                "label": "3 days"
+              },
+              {
+                "value": "604800",
+                "label": "1 week"
+              }
+            ],
+            "default": "0",
+            "visibleWhen": {
+              "field": "thirdAction",
+              "equals": "ban"
+            }
+          },
+          {
+            "key": "firstDemoteRoleIds",
+            "type": "discord-role",
+            "label": "First-offence demotion roles",
+            "description": "Eligible roles removed when the first action is Demote.",
+            "group": "Repeat offender",
+            "required": false,
+            "supportVisibility": "value",
+            "multiple": true,
+            "minItems": 0,
+            "maxItems": 10,
+            "visibleWhen": {
+              "field": "firstAction",
+              "equals": "demote"
+            }
+          },
+          {
+            "key": "secondDemoteRoleIds",
+            "type": "discord-role",
+            "label": "Second-offence demotion roles",
+            "description": "Eligible roles removed when the second action is Demote.",
+            "group": "Repeat offender",
+            "required": false,
+            "supportVisibility": "value",
+            "multiple": true,
+            "minItems": 0,
+            "maxItems": 10,
+            "visibleWhen": {
+              "field": "secondAction",
+              "equals": "demote"
+            }
+          },
+          {
+            "key": "thirdDemoteRoleIds",
+            "type": "discord-role",
+            "label": "Third-offence demotion roles",
+            "description": "Eligible roles removed when the third action is Demote.",
+            "group": "Repeat offender",
+            "required": false,
+            "supportVisibility": "value",
+            "multiple": true,
+            "minItems": 0,
+            "maxItems": 10,
+            "visibleWhen": {
+              "field": "thirdAction",
+              "equals": "demote"
+            }
+          }
+        ],
+        "editableFields": [
+          {
+            "statuses": ["draft", "published", "disabled", "review"],
+            "fields": [
+              "name",
+              "category",
+              "ruleKind",
+              "keywordFilter",
+              "regexPatterns",
+              "allowList",
+              "enhancedNormalisedMatching",
+              "enhancedFuzzyMatching",
+              "presetProfanity",
+              "presetSexualContent",
+              "presetSlurs",
+              "mentionTotalLimit",
+              "mentionRaidProtectionEnabled",
+              "blockMessage",
+              "blockExplanation",
+              "alertChannelId",
+              "nativeTimeoutSeconds",
+              "ignoredRoleIds",
+              "ignoredChannelIds",
+              "openViolationThread",
+              "firstAction",
+              "secondAction",
+              "thirdAction",
+              "firstTimeoutSeconds",
+              "secondTimeoutSeconds",
+              "thirdTimeoutSeconds",
+              "firstBanDeleteMessageSeconds",
+              "secondBanDeleteMessageSeconds",
+              "thirdBanDeleteMessageSeconds",
+              "firstDemoteRoleIds",
+              "secondDemoteRoleIds",
+              "thirdDemoteRoleIds"
+            ]
+          }
+        ],
+        "deleteStatuses": ["draft"],
+        "actions": [
+          {
+            "id": "disable",
+            "permissionId": "automod.rules.publish",
+            "label": "Disable",
+            "description": "Disable the owned Discord rule while preserving its mapping.",
+            "style": "secondary",
+            "confirmationPolicy": "required",
+            "confirmation": "Disable this Helyx-owned Discord rule?",
+            "statuses": ["published", "drifted"]
+          },
+          {
+            "id": "adopt-discord",
+            "permissionId": "automod.rules.reconcile",
+            "label": "Adopt current Discord values",
+            "description": "Replace native portions of the Helyx definition with the current owned Discord rule.",
+            "style": "secondary",
+            "confirmationPolicy": "required",
+            "confirmation": "Adopt the current Discord values for this mapped rule?",
+            "statuses": ["drifted"]
+          },
+          {
+            "id": "restore-helyx",
+            "permissionId": "automod.rules.reconcile",
+            "label": "Restore Helyx values",
+            "description": "Restore the published Helyx definition to the owned Discord rule.",
+            "style": "primary",
+            "confirmationPolicy": "required",
+            "confirmation": "Overwrite the current owned Discord rule with the Helyx definition?",
+            "statuses": ["drifted"]
+          },
+          {
+            "id": "cleanup-owned-discord",
+            "permissionId": "automod.rules.reconcile",
+            "label": "Clean up owned Discord rule",
+            "description": "Delete only the mapped Helyx-owned Discord rule and retain this unpublished rule record.",
+            "style": "danger",
+            "confirmationPolicy": "required",
+            "confirmation": "Delete this mapped Helyx-owned Discord rule? Helyx never deletes unowned rules.",
+            "statuses": ["disabled", "missing", "review"]
+          }
+        ],
+        "import": {
+          "label": "Import terms",
+          "description": "Parse a bounded comma or newline-separated UTF-8 term list into a reviewable draft.",
+          "inputFormat": "utf8_text",
+          "maxBytes": 4000
+        },
+        "query": {
+          "search": {
+            "label": "Find rule",
+            "placeholder": "Rule name"
+          },
+          "filters": [
+            {
+              "key": "status",
+              "label": "Status",
+              "type": "select",
+              "options": [
+                {
+                  "value": "draft",
+                  "label": "Draft"
+                },
+                {
+                  "value": "published",
+                  "label": "Published"
+                },
+                {
+                  "value": "disabled",
+                  "label": "Disabled"
+                },
+                {
+                  "value": "drifted",
+                  "label": "Drifted"
+                },
+                {
+                  "value": "missing",
+                  "label": "Missing"
+                },
+                {
+                  "value": "review",
+                  "label": "Review"
+                }
+              ]
+            }
+          ]
+        }
+      },
+      {
+        "id": "automod-activity",
+        "name": "Activity",
+        "singularName": "Activity receipt",
+        "description": "Content-free structural receipts from owned Discord Auto Moderation rules.",
+        "operations": ["list", "read"],
+        "permissions": {
+          "list": "automod.activity.read",
+          "read": "automod.activity.read"
+        },
+        "tablePresentation": {
+          "primaryColumnLabel": "Receipt",
+          "showStatus": true,
+          "showUpdated": true,
+          "openAction": "primary",
+          "responsive": "stacked"
+        },
+        "columns": [
+          {
+            "key": "ruleId",
+            "label": "Rule",
+            "format": "text"
+          },
+          {
+            "key": "source",
+            "label": "Source",
+            "format": "text"
+          },
+          {
+            "key": "action",
+            "label": "Action",
+            "format": "text"
+          },
+          {
+            "key": "outcome",
+            "label": "Outcome",
+            "format": "text"
+          },
+          {
+            "key": "caseId",
+            "label": "Moderation case",
+            "format": "text"
+          }
+        ],
+        "fields": [
+          {
+            "key": "ruleId",
+            "type": "string",
+            "label": "Rule ID",
+            "description": "Logical Helyx rule identifier.",
+            "required": true,
+            "supportVisibility": "value",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          {
+            "key": "ruleRevision",
+            "type": "integer",
+            "label": "Rule revision",
+            "description": "Rule revision active for this event.",
+            "required": true,
+            "supportVisibility": "value",
+            "minimum": 1,
+            "maximum": 2147483647
+          },
+          {
+            "key": "configurationRevision",
+            "type": "string",
+            "label": "Configuration revision",
+            "description": "Configuration revision active for this event.",
+            "required": true,
+            "supportVisibility": "value",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          {
+            "key": "source",
+            "type": "string",
+            "label": "Detection source",
+            "description": "Discord-native or Enhanced detection source.",
+            "required": true,
+            "supportVisibility": "value",
+            "minLength": 1,
+            "maxLength": 20
+          },
+          {
+            "key": "action",
+            "type": "string",
+            "label": "Action",
+            "description": "Structural detection or Discord action family.",
+            "required": true,
+            "supportVisibility": "value",
+            "minLength": 1,
+            "maxLength": 50
+          },
+          {
+            "key": "detectionMethod",
+            "type": "string",
+            "label": "Detection method",
+            "description": "Enhanced matching method when applicable.",
+            "required": false,
+            "supportVisibility": "value",
+            "minLength": 0,
+            "maxLength": 50
+          },
+          {
+            "key": "confidenceClass",
+            "type": "string",
+            "label": "Confidence class",
+            "description": "Bounded Enhanced confidence class when applicable.",
+            "required": false,
+            "supportVisibility": "value",
+            "minLength": 0,
+            "maxLength": 50
+          },
+          {
+            "key": "confidenceScore",
+            "type": "integer",
+            "label": "Confidence score",
+            "description": "Enhanced confidence score from 0 to 100.",
+            "required": false,
+            "supportVisibility": "value",
+            "minimum": 0,
+            "maximum": 100
+          },
+          {
+            "key": "effectiveThreshold",
+            "type": "integer",
+            "label": "Effective threshold",
+            "description": "Confidence threshold required for this detection.",
+            "required": false,
+            "supportVisibility": "value",
+            "minimum": 60,
+            "maximum": 100
+          },
+          {
+            "key": "outcome",
+            "type": "string",
+            "label": "Outcome",
+            "description": "Safe processing outcome.",
+            "required": true,
+            "supportVisibility": "value",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          {
+            "key": "safeCode",
+            "type": "string",
+            "label": "Processing reason",
+            "description": "Automatic diagnostic code explaining a duplicate, skipped action or processing failure. Blank when no additional reason was recorded; this is not a safety or confidence rating.",
+            "required": false,
+            "supportVisibility": "value",
+            "minLength": 0,
+            "maxLength": 100
+          },
+          {
+            "key": "moderationCaseId",
+            "type": "string",
+            "label": "Moderation case",
+            "description": "Optional linked Moderation case ID.",
+            "required": false,
+            "supportVisibility": "value",
+            "minLength": 0,
+            "maxLength": 100
+          },
+          {
+            "key": "occurredAt",
+            "type": "string",
+            "label": "Occurred at",
+            "description": "Discord structural event time.",
+            "required": true,
+            "supportVisibility": "value",
+            "minLength": 1,
+            "maxLength": 50
+          }
+        ],
+        "query": {
+          "filters": [
+            {
+              "key": "ruleId",
+              "label": "Rule ID",
+              "type": "string",
+              "placeholder": "Exact logical rule ID"
+            },
+            {
+              "key": "outcome",
+              "label": "Outcome",
+              "type": "select",
+              "options": [
+                {
+                  "value": "applied",
+                  "label": "Applied"
+                },
+                {
+                  "value": "already_applied",
+                  "label": "Already applied"
+                },
+                {
+                  "value": "native_only",
+                  "label": "Native only"
+                },
+                {
+                  "value": "rejected",
+                  "label": "Rejected"
+                },
+                {
+                  "value": "failed",
+                  "label": "Failed"
+                },
+                {
+                  "value": "ambiguous",
+                  "label": "Ambiguous"
+                },
+                {
+                  "value": "review_required",
+                  "label": "Review required"
+                }
+              ]
+            }
+          ]
+        }
+      }
+    ],
+    "workspace": {
+      "type": "managed_resources_v1",
+      "tabs": [
+        {
+          "id": "rules",
+          "label": "Rules",
+          "panels": [
+            {
+              "resources": ["automod-rules"]
+            }
+          ]
+        },
+        {
+          "id": "activity",
+          "label": "Activity",
+          "panels": [
+            {
+              "resources": ["automod-activity"],
+              "mode": "list-only"
+            }
+          ]
+        }
+      ]
+    }
+  },
+  "contributions": {
+    "commands": [],
+    "events": [
+      "discord.auto-moderation-rule-create",
+      "discord.auto-moderation-rule-update",
+      "discord.auto-moderation-rule-delete",
+      "discord.auto-moderation-action-execution",
+      "discord.privileged-message-create",
+      "discord.privileged-message-update"
+    ],
+    "logs": [
+      "automod-rule-triggered",
+      "automod-rule-drifted",
+      "automod-enhanced-detected",
+      "automod-enforcement-failed"
+    ]
+  }
+}