specmem-hardwicksoftware 3.5.99

package/dist/commands/commandLoader.js

@@ -0,0 +1,223 @@
+/**
+ * CommandLoader - Load command .md files as MCP prompts
+ *
+ * This loads specmem command files from the commands/ directory
+ * and registers them as MCP prompts so  can use them anywhere
+ * the MCP server is deployed.
+ *
+ * Commands become prompts like:
+ * - specmem-remember
+ * - specmem-find
+ * - specmem-code
+ * - specmem-stats
+ * - etc.
+ */
+import { readFileSync, readdirSync, existsSync } from 'fs';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+import { logger } from '../utils/logger.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * CommandLoader - scans commands/ dir and loads as MCP prompts
+ */
+export class CommandLoader {
+    commands = new Map();
+    commandsDir;
+    constructor(commandsDir) {
+        // Default to commands/ directory relative to project root
+        // Go up from src/commands to project root, then into commands/
+        this.commandsDir = commandsDir || join(__dirname, '..', '..', 'commands');
+        this.loadCommands();
+    }
+    /**
+     * Load all command .md files from the commands directory
+     */
+    loadCommands() {
+        if (!existsSync(this.commandsDir)) {
+            logger.warn({ dir: this.commandsDir }, 'commands directory not found');
+            return;
+        }
+        try {
+            const files = readdirSync(this.commandsDir)
+                .filter(f => f.endsWith('.md') && f.startsWith('specmem'));
+            for (const file of files) {
+                try {
+                    const filePath = join(this.commandsDir, file);
+                    const content = readFileSync(filePath, 'utf-8');
+                    const name = basename(file, '.md');
+                    const description = this.extractDescription(content);
+                    const command = {
+                        name,
+                        fileName: file,
+                        content,
+                        description,
+                        usage: this.extractUsage(content)
+                    };
+                    this.commands.set(name, command);
+                    logger.debug({ name, file }, 'loaded command');
+                }
+                catch (err) {
+                    logger.error({ file, error: err }, 'failed to load command file');
+                }
+            }
+            logger.info({ count: this.commands.size, dir: this.commandsDir }, 'commands loaded');
+        }
+        catch (err) {
+            logger.error({ error: err, dir: this.commandsDir }, 'failed to read commands directory');
+        }
+    }
+    /**
+     * Extract description from command file (first non-empty line after title)
+     */
+    extractDescription(content) {
+        const lines = content.split('\n');
+        let foundTitle = false;
+        for (const line of lines) {
+            if (line.startsWith('# ')) {
+                foundTitle = true;
+                // Check if there's a subtitle on same line
+                const parts = line.split(' - ');
+                if (parts.length > 1) {
+                    return parts[1]?.trim() || 'SpecMem command';
+                }
+                continue;
+            }
+            if (foundTitle && line.trim() && !line.startsWith('#')) {
+                return line.trim();
+            }
+        }
+        return 'SpecMem command';
+    }
+    /**
+     * Extract usage section from command file
+     */
+    extractUsage(content) {
+        const usageMatch = content.match(/## Usage\s*\n```[^\n]*\n([\s\S]*?)```/);
+        return usageMatch?.[1]?.trim();
+    }
+    /**
+     * Get all commands as MCP prompts
+     */
+    getPrompts() {
+        const prompts = [];
+        for (const [name, command] of this.commands) {
+            prompts.push({
+                name,
+                description: command.description,
+                arguments: [
+                    {
+                        name: 'args',
+                        description: 'Optional arguments for the command',
+                        required: false
+                    }
+                ]
+            });
+        }
+        // Add master prompt that lists all commands
+        prompts.push({
+            name: 'specmem-help',
+            description: 'List all available SpecMem commands',
+            arguments: []
+        });
+        return prompts;
+    }
+    /**
+     * Get prompt messages for a specific command
+     */
+    getPromptMessages(promptName, args) {
+        // Handle help prompt
+        if (promptName === 'specmem-help') {
+            return this.getHelpMessages();
+        }
+        const command = this.commands.get(promptName);
+        if (!command) {
+            return [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Command not found: ${promptName}\n\nAvailable commands:\n${this.getCommandList()}`
+                    }
+                }];
+        }
+        // Return the full command content with any args appended
+        let text = command.content;
+        if (args?.args) {
+            text += `\n\n---\n\n**User Arguments:** ${args.args}`;
+        }
+        return [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text
+                }
+            }];
+    }
+    /**
+     * Get help messages listing all commands
+     */
+    getHelpMessages() {
+        let text = '# SpecMem Commands\n\n';
+        text += 'Available commands that can be used as MCP prompts:\n\n';
+        for (const [name, command] of this.commands) {
+            text += `## ${name}\n`;
+            text += `${command.description}\n`;
+            if (command.usage) {
+                text += `\n\`\`\`\n${command.usage}\n\`\`\`\n`;
+            }
+            text += '\n';
+        }
+        text += '---\n\n';
+        text += 'Use any command by name (e.g., `specmem-remember`) to get detailed instructions.\n';
+        return [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text
+                }
+            }];
+    }
+    /**
+     * Get simple command list
+     */
+    getCommandList() {
+        return Array.from(this.commands.keys()).map(n => `- ${n}`).join('\n');
+    }
+    /**
+     * Get a specific command by name
+     */
+    getCommand(name) {
+        return this.commands.get(name);
+    }
+    /**
+     * Get all loaded commands
+     */
+    getAllCommands() {
+        return Array.from(this.commands.values());
+    }
+    /**
+     * Reload commands from disk
+     */
+    reload() {
+        this.commands.clear();
+        this.loadCommands();
+    }
+}
+// Singleton instance
+let loaderInstance = null;
+/**
+ * Get the command loader singleton
+ */
+export function getCommandLoader(commandsDir) {
+    if (!loaderInstance) {
+        loaderInstance = new CommandLoader(commandsDir);
+    }
+    return loaderInstance;
+}
+/**
+ * Reset the command loader (for testing)
+ */
+export function resetCommandLoader() {
+    loaderInstance = null;
+}
+//# sourceMappingURL=commandLoader.js.map

package/dist/commands/commandLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandLoader.js","sourceRoot":"","sources":["../../src/commands/commandLoader.ts"],"names":[],"mappings":"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"}

package/dist/commands/contextCommands.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ContextCommands - conversation context management for 
+ *
+ * save and load conversation contexts fr
+ * - /context save - save current conversation
+ * - /context load <id> - load previous conversation
+ * - /context list - list all saved contexts
+ * - /context clear - clear current context
+ *
+ * this is how claude remembers what yall were talking about
+ */
+import { CommandCategory, CommandAction, CommandResult } from './commandHandler.js';
+import { DatabaseManager } from '../database.js';
+interface ContextMessage {
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+}
+/**
+ * ContextCommands - manage conversation contexts
+ *
+ * save your convos and pick up where you left off
+ */
+export declare class ContextCommands implements CommandCategory {
+    private db;
+    name: string;
+    description: string;
+    actions: Map<string, CommandAction>;
+    private currentContext;
+    private currentContextId;
+    private currentContextName;
+    constructor(db: DatabaseManager);
+    private registerActions;
+    /**
+     * Ensure the contexts table exists
+     */
+    private ensureContextTable;
+    handleAction(action: string, args: string[]): Promise<CommandResult>;
+    /**
+     * Handle /context save
+     */
+    private handleSave;
+    /**
+     * Handle /context load
+     */
+    private handleLoad;
+    /**
+     * Handle /context list
+     */
+    private handleList;
+    /**
+     * Handle /context clear
+     */
+    private handleClear;
+    /**
+     * Handle /context current
+     */
+    private handleCurrent;
+    /**
+     * Handle /context delete
+     */
+    private handleDelete;
+    /**
+     * Handle /context add - add a message to current context
+     */
+    private handleAdd;
+    /**
+     * Generate a summary of the current context
+     */
+    private generateSummary;
+    /**
+     * Public method to add messages (for integration with chat handlers)
+     */
+    addMessage(role: 'user' | 'assistant', content: string): void;
+    /**
+     * Get current context messages
+     */
+    getContext(): ContextMessage[];
+    private parseArgs;
+    getHelp(): string;
+}
+export {};
+//# sourceMappingURL=contextCommands.d.ts.map

package/dist/commands/contextCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextCommands.d.ts","sourceRoot":"","sources":["../../src/commands/contextCommands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAgBjD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,eAAe;IAUzC,OAAO,CAAC,EAAE;IATtB,IAAI,SAAa;IACjB,WAAW,SAA+E;IAC1F,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAa;IAGhD,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,kBAAkB,CAAuB;gBAE7B,EAAE,EAAE,eAAe;IAKvC,OAAO,CAAC,eAAe;IA2EvB;;OAEG;YACW,kBAAkB;IA4B1B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA2B1E;;OAEG;YACW,UAAU;IAuExB;;OAEG;YACW,UAAU;IA4DxB;;OAEG;YACW,UAAU;IAiDxB;;OAEG;YACW,WAAW;IAyBzB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;YACW,YAAY;IA6C1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAuCjB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ7D;;OAEG;IACH,UAAU,IAAI,cAAc,EAAE;IAI9B,OAAO,CAAC,SAAS;IA+BjB,OAAO,IAAI,MAAM;CAclB"}