@trenchwork/erosolar 1.1.16

package/dist/shell/autoExecutor.js

@@ -0,0 +1,320 @@
+/**
+ * Auto-executor for validation gaps, recommendations, and follow-ups
+ *
+ * This module parses assistant responses and automatically executes:
+ * - Validation gaps (e.g., npm install if tests fail)
+ * - Recommendations (e.g., remove unnecessary files)
+ * - Follow-up tasks (e.g., git status)
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { unlink, rm } from 'node:fs/promises';
+const execAsync = promisify(exec);
+/**
+ * Parse assistant response for structured actions
+ */
+export function parseAssistantResponse(response) {
+    const validationGaps = [];
+    const recommendations = [];
+    const followUps = [];
+    // Parse validation gaps
+    const validationGapPattern = /Validation Gap:?\s*(.+?)(?:\n|$)/gi;
+    let match;
+    while ((match = validationGapPattern.exec(response)) !== null) {
+        const description = match[1]?.trim();
+        if (description) {
+            const command = extractCommand(description);
+            if (command) {
+                validationGaps.push({
+                    type: 'validation_gap',
+                    description,
+                    command,
+                    autoExecutable: isAutoExecutable(command),
+                });
+            }
+        }
+    }
+    // Parse common validation gap patterns
+    if (response.includes('npm install') && response.includes('dependencies')) {
+        validationGaps.push({
+            type: 'validation_gap',
+            description: 'Install dependencies to run tests',
+            command: 'npm install',
+            autoExecutable: true,
+        });
+    }
+    // Parse recommendations
+    const recommendationPattern = /Recommend(?:ation)?s?:?\s*(.+?)(?:\n|$)/gi;
+    while ((match = recommendationPattern.exec(response)) !== null) {
+        const description = match[1]?.trim();
+        if (description) {
+            const action = parseRecommendationAction(description);
+            if (action) {
+                recommendations.push(action);
+            }
+        }
+    }
+    // Parse follow-ups
+    const followUpPattern = /Follow[- ]?[Uu]ps?:?\s*(.+?)(?:\n|$)/gi;
+    while ((match = followUpPattern.exec(response)) !== null) {
+        const description = match[1]?.trim();
+        if (description) {
+            const command = extractCommand(description);
+            if (command) {
+                followUps.push({
+                    type: 'follow_up',
+                    description,
+                    command,
+                    autoExecutable: isAutoExecutable(command),
+                });
+            }
+        }
+    }
+    // Parse common follow-up patterns
+    if (response.match(/run\s+`?git status`?/i)) {
+        followUps.push({
+            type: 'follow_up',
+            description: 'Check git status for untracked files',
+            command: 'git status',
+            autoExecutable: true,
+        });
+    }
+    return { validationGaps, recommendations, followUps };
+}
+/**
+ * Extract command from description text
+ */
+function extractCommand(text) {
+    // Look for commands in backticks or quotes
+    const backtickMatch = text.match(/`([^`]+)`/);
+    if (backtickMatch && backtickMatch[1]) {
+        return backtickMatch[1];
+    }
+    // Look for npm commands
+    const npmMatch = text.match(/npm\s+(?:run\s+)?[\w:-]+/);
+    if (npmMatch) {
+        return npmMatch[0];
+    }
+    // Look for git commands
+    const gitMatch = text.match(/git\s+[\w-]+(?:\s+[^\s]+)*/);
+    if (gitMatch) {
+        return gitMatch[0];
+    }
+    return null;
+}
+/**
+ * Parse recommendation action from description
+ */
+function parseRecommendationAction(description) {
+    // Check for file/directory removal
+    if (description.match(/remove|delete/i)) {
+        const pathMatch = description.match(/[./][\w/.-]+/);
+        if (pathMatch) {
+            const target = pathMatch[0];
+            return {
+                type: 'recommendation',
+                description,
+                action: target.includes('.') ? 'remove_file' : 'remove_dir',
+                target,
+                requiresConfirmation: true,
+            };
+        }
+    }
+    // Check for command execution
+    const command = extractCommand(description);
+    if (command) {
+        return {
+            type: 'recommendation',
+            description,
+            action: 'run_command',
+            command,
+            requiresConfirmation: !isAutoExecutable(command),
+        };
+    }
+    return null;
+}
+/**
+ * Check if command is safe to auto-execute.
+ * Safe commands are: read-only, idempotent, or standard dev workflow commands
+ * that don't modify system state outside the project.
+ */
+function isAutoExecutable(command) {
+    const safeCommands = [
+        // Package management (install only, not publish/uninstall)
+        /^npm\s+install$/,
+        /^npm\s+i$/,
+        /^npm\s+ci$/,
+        /^pnpm\s+install$/,
+        /^yarn(\s+install)?$/,
+        // Standard dev workflow scripts
+        /^npm\s+test(\s|$)/,
+        /^npm\s+run\s+(?:test|build|lint|type-check|typecheck|check|verify|compile|format|prettier|eslint)(?::\w+)?$/,
+        /^pnpm\s+(?:test|build|lint|type-check|typecheck)$/,
+        /^yarn\s+(?:test|build|lint|type-check|typecheck)$/,
+        // Direct tool invocations (read-only / idempotent)
+        /^npx\s+(?:tsc|eslint|prettier|jest|vitest|mocha)(?:\s|$)/,
+        /^tsc(?:\s+--noEmit)?$/,
+        /^eslint\s/,
+        /^prettier\s+--check\s/,
+        // Git read-only commands
+        /^git\s+status$/,
+        /^git\s+diff(?:\s|$)/,
+        /^git\s+log(?:\s|$)/,
+        /^git\s+show(?:\s|$)/,
+        /^git\s+branch(?:\s+-[avr])?$/,
+        /^git\s+remote\s+-v$/,
+        // Read-only filesystem commands
+        /^ls(?:\s|$)/,
+        /^cat\s/,
+        /^head\s/,
+        /^tail\s/,
+        /^wc\s/,
+        /^find\s.*-type\s+[fd](?:\s|$)/,
+        /^du\s/,
+        /^df\s/,
+    ];
+    return safeCommands.some((pattern) => pattern.test(command));
+}
+/**
+ * Execute a validation gap
+ */
+export async function executeValidationGap(gap, workingDir) {
+    try {
+        const { stdout, stderr } = await execAsync(gap.command, {
+            cwd: workingDir,
+            timeout: 10 * 60 * 1000, // 10 minutes
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+        });
+        return {
+            success: true,
+            output: stdout || stderr,
+        };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            success: false,
+            output: err?.stdout || '',
+            error: err?.stderr || err?.message,
+        };
+    }
+}
+/**
+ * Execute a recommendation
+ */
+export async function executeRecommendation(recommendation, workingDir) {
+    try {
+        switch (recommendation.action) {
+            case 'remove_file':
+                if (recommendation.target) {
+                    const fullPath = `${workingDir}/${recommendation.target}`;
+                    await unlink(fullPath);
+                    return {
+                        success: true,
+                        output: `Removed file: ${recommendation.target}`,
+                    };
+                }
+                break;
+            case 'remove_dir':
+                if (recommendation.target) {
+                    const fullPath = `${workingDir}/${recommendation.target}`;
+                    await rm(fullPath, { recursive: true });
+                    return {
+                        success: true,
+                        output: `Removed directory: ${recommendation.target}`,
+                    };
+                }
+                break;
+            case 'run_command':
+                if (recommendation.command) {
+                    const { stdout, stderr } = await execAsync(recommendation.command, {
+                        cwd: workingDir,
+                        timeout: 5 * 60 * 1000,
+                        maxBuffer: 10 * 1024 * 1024,
+                    });
+                    return {
+                        success: true,
+                        output: stdout || stderr,
+                    };
+                }
+                break;
+        }
+        return {
+            success: false,
+            output: '',
+            error: 'Invalid recommendation action',
+        };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            success: false,
+            output: '',
+            error: err?.message || 'Recommendation execution failed',
+        };
+    }
+}
+/**
+ * Execute a follow-up task
+ */
+export async function executeFollowUp(followUp, workingDir) {
+    try {
+        const { stdout, stderr } = await execAsync(followUp.command, {
+            cwd: workingDir,
+            timeout: 5 * 60 * 1000,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        return {
+            success: true,
+            output: stdout || stderr,
+        };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            success: false,
+            output: err?.stdout || '',
+            error: err?.stderr || err?.message,
+        };
+    }
+}
+/**
+ * Execute all auto-executable actions
+ */
+export async function executeAutoActions(actions, workingDir, options = {}) {
+    const results = [];
+    let executed = 0;
+    let failed = 0;
+    // Execute validation gaps
+    for (const gap of actions.validationGaps) {
+        if (gap.autoExecutable) {
+            const result = await executeValidationGap(gap, workingDir);
+            results.push({ type: 'validation_gap', description: gap.description, result });
+            executed++;
+            if (!result.success)
+                failed++;
+        }
+    }
+    // Execute recommendations (only if skipConfirmation or requiresConfirmation is false)
+    for (const rec of actions.recommendations) {
+        if (!rec.requiresConfirmation || options.skipConfirmation) {
+            const result = await executeRecommendation(rec, workingDir);
+            results.push({ type: 'recommendation', description: rec.description, result });
+            executed++;
+            if (!result.success)
+                failed++;
+        }
+    }
+    // Execute follow-ups
+    for (const followUp of actions.followUps) {
+        if (followUp.autoExecutable) {
+            const result = await executeFollowUp(followUp, workingDir);
+            results.push({ type: 'follow_up', description: followUp.description, result });
+            executed++;
+            if (!result.success)
+                failed++;
+        }
+    }
+    return { executed, failed, results };
+}
+//# sourceMappingURL=autoExecutor.js.map

package/dist/shell/autoExecutor.js.map

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

package/dist/shell/commandRegistry.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Command Registry - Slash Command Management
+ *
+ * Provides a registry for slash commands with:
+ * - Command registration and discovery
+ * - Help text generation
+ * - Category organization
+ * - Command execution delegation
+ *
+ * Usage:
+ * ```typescript
+ * const registry = new CommandRegistry();
+ *
+ * registry.register({
+ *   name: '/help',
+ *   aliases: ['/?'],
+ *   description: 'Show help information',
+ *   category: 'navigation',
+ *   handler: async (context) => {
+ *     context.showHelp();
+ *   },
+ * });
+ *
+ * await registry.execute('/help', '', context);
+ * ```
+ */
+export type CommandCategory = 'navigation' | 'model' | 'context' | 'session' | 'tools' | 'learning';
+export interface CommandContext {
+    /** The shell instance for accessing shell methods */
+    shell: unknown;
+    /** Current input/arguments */
+    input: string;
+    /** Raw command string */
+    rawCommand: string;
+}
+export interface CommandDefinition {
+    /** Primary command name (e.g., '/help') */
+    name: string;
+    /** Alternative names for the command */
+    aliases?: string[];
+    /** Short description for help text */
+    description: string;
+    /** Category for organization */
+    category: CommandCategory;
+    /** Whether command is async */
+    async?: boolean;
+    /** Whether command is hidden from help */
+    hidden?: boolean;
+    /** Usage example */
+    usage?: string;
+    /** Handler function */
+    handler: (context: CommandContext) => void | Promise<void>;
+}
+export interface CommandMatch {
+    command: CommandDefinition;
+    matchedName: string;
+}
+export declare class CommandRegistry {
+    private commands;
+    private aliasMap;
+    /**
+     * Register a command
+     */
+    register(command: CommandDefinition): this;
+    /**
+     * Register multiple commands
+     */
+    registerAll(commands: CommandDefinition[]): this;
+    /**
+     * Find a command by name or alias
+     */
+    find(commandName: string): CommandMatch | null;
+    /**
+     * Check if a command exists
+     */
+    has(commandName: string): boolean;
+    /**
+     * Execute a command
+     */
+    execute(commandName: string, input: string, shell: unknown): Promise<boolean>;
+    /**
+     * Get all commands in a category
+     */
+    getByCategory(category: CommandCategory): CommandDefinition[];
+    /**
+     * Get all categories with their commands
+     */
+    getAllCategories(): Map<CommandCategory, CommandDefinition[]>;
+    /**
+     * Get all registered commands
+     */
+    getAll(): CommandDefinition[];
+    /**
+     * Get all visible commands (excluding hidden)
+     */
+    getVisible(): CommandDefinition[];
+    /**
+     * Generate help text for all commands
+     */
+    generateHelpText(): string;
+    /**
+     * Generate compact help text (just command names)
+     */
+    generateCompactHelp(): string;
+    /**
+     * Normalize command name
+     */
+    private normalizeName;
+    /**
+     * Format category name for display
+     */
+    private formatCategoryName;
+}
+/**
+ * Create a standard set of commands for the shell
+ *
+ * This is meant to be extended/customized by the shell implementation
+ */
+export declare function createBaseCommands(): CommandDefinition[];
+export declare function getCommandRegistry(): CommandRegistry;
+export declare function resetCommandRegistry(): void;
+//# sourceMappingURL=commandRegistry.d.ts.map

package/dist/shell/commandRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandRegistry.d.ts","sourceRoot":"","sources":["../../src/shell/commandRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAYH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,OAAO,GACP,SAAS,GACT,SAAS,GACT,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,EAAE,eAAe,CAAC;IAC1B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,QAAQ,CAA6B;IAE7C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAgB1C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAOhD;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAqB9C;;OAEG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBnF;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,iBAAiB,EAAE;IAM7D;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,eAAe,EAAE,iBAAiB,EAAE,CAAC;IAc7D;;OAEG;IACH,MAAM,IAAI,iBAAiB,EAAE;IAI7B;;OAEG;IACH,UAAU,IAAI,iBAAiB,EAAE;IAIjC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IA8B1B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAO7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAW3B;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,EAAE,CAkJxD;AAQD,wBAAgB,kBAAkB,IAAI,eAAe,CAMpD;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}