@affectively/slash-commands 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.0] - 2026-02-17
+
+### Added
+
+- Native `/help` and `/?` command support in `executeSlashCommand`
+- Categorized help output with parameter documentation
+- Tier-aware help filtering (only shows commands available to user)
+
 ## [1.0.0] - 2026-01-25
 
 ### Added

package/dist/index.js

@@ -687,6 +687,39 @@ var SlashCommandRegistry = class {
 var slashCommandRegistry = new SlashCommandRegistry();
 async function executeSlashCommand(input, context, executor) {
   const startTime = Date.now();
+  const trimmedInput = input.trim();
+  if (trimmedInput === "/help" || trimmedInput === "/?") {
+    const commands = slashCommandRegistry.getForTier(context.userTier);
+    const categories = slashCommandRegistry.getCountByCategory();
+    let helpText = "## Available Slash Commands\n\n";
+    const grouped = commands.reduce((acc, cmd) => {
+      if (!acc[cmd.category]) acc[cmd.category] = [];
+      acc[cmd.category].push(cmd);
+      return acc;
+    }, {});
+    for (const [category, cmds] of Object.entries(grouped)) {
+      helpText += `### ${category.toUpperCase()}
+`;
+      for (const cmd of cmds) {
+        helpText += `- \`/${cmd.name}\`: ${cmd.description}
+`;
+        if (cmd.parameters.length > 0) {
+          const params = cmd.parameters.map((p) => `${p.name}${p.required ? "*" : ""}`).join(", ");
+          helpText += `  *Params: ${params}*
+`;
+        }
+      }
+      helpText += "\n";
+    }
+    helpText += '\n*Type `/command {args}` to execute a command. JSON input is supported: `/command {"key": "value"}`*';
+    return {
+      success: true,
+      data: helpText,
+      executionTimeMs: Date.now() - startTime,
+      command: "help",
+      args: {}
+    };
+  }
   const parsed = parseSlashCommand(input, slashCommandRegistry.getMap());
   if (!parsed.found) {
     return {

package/dist/index.mjs

@@ -637,6 +637,39 @@ var SlashCommandRegistry = class {
 var slashCommandRegistry = new SlashCommandRegistry();
 async function executeSlashCommand(input, context, executor) {
   const startTime = Date.now();
+  const trimmedInput = input.trim();
+  if (trimmedInput === "/help" || trimmedInput === "/?") {
+    const commands = slashCommandRegistry.getForTier(context.userTier);
+    const categories = slashCommandRegistry.getCountByCategory();
+    let helpText = "## Available Slash Commands\n\n";
+    const grouped = commands.reduce((acc, cmd) => {
+      if (!acc[cmd.category]) acc[cmd.category] = [];
+      acc[cmd.category].push(cmd);
+      return acc;
+    }, {});
+    for (const [category, cmds] of Object.entries(grouped)) {
+      helpText += `### ${category.toUpperCase()}
+`;
+      for (const cmd of cmds) {
+        helpText += `- \`/${cmd.name}\`: ${cmd.description}
+`;
+        if (cmd.parameters.length > 0) {
+          const params = cmd.parameters.map((p) => `${p.name}${p.required ? "*" : ""}`).join(", ");
+          helpText += `  *Params: ${params}*
+`;
+        }
+      }
+      helpText += "\n";
+    }
+    helpText += '\n*Type `/command {args}` to execute a command. JSON input is supported: `/command {"key": "value"}`*';
+    return {
+      success: true,
+      data: helpText,
+      executionTimeMs: Date.now() - startTime,
+      command: "help",
+      args: {}
+    };
+  }
   const parsed = parseSlashCommand(input, slashCommandRegistry.getMap());
   if (!parsed.found) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@affectively/slash-commands",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Slash command parser with Zod schema integration. Auto-generates commands from Zod schemas with autocomplete, validation, and type coercion for CLI and chat interfaces.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",