@dotsetlabs/tollgate 0.2.2 → 0.3.0

package/dist/guard/alternatives/index.js

@@ -0,0 +1,224 @@
+/**
+ * Safer Alternatives Engine for Shell Guardian
+ *
+ * Suggests safer ways to accomplish the same goal as a risky command.
+ */
+import { execSync } from 'node:child_process';
+import { getAlternativeMappings } from './registry.js';
+export { getAlternativeMappings, ALTERNATIVE_MAPPINGS } from './registry.js';
+/**
+ * Default options for the alternatives finder.
+ */
+const DEFAULT_OPTIONS = {
+    maxAlternatives: 5,
+    minSafetyImprovement: 10,
+    checkToolAvailability: false,
+};
+/**
+ * Find safer alternatives for a command.
+ *
+ * @param command - The command to find alternatives for
+ * @param context - Enhanced context information
+ * @param analysis - Risk analysis of the command
+ * @param options - Finder options
+ * @returns Alternative suggestions
+ */
+export function findAlternatives(command, context, analysis, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const mappings = getAlternativeMappings();
+    const matchedPatterns = [];
+    const contextFactors = [];
+    let alternatives = [];
+    // Record context factors
+    if (context.project) {
+        contextFactors.push(`Project: ${context.project.type}`);
+    }
+    if (context.git?.isRepo) {
+        contextFactors.push('Git repository');
+        if (context.git.hasUncommittedChanges) {
+            contextFactors.push('Has uncommitted changes');
+        }
+    }
+    if (context.directory) {
+        contextFactors.push(`Directory sensitivity: ${context.directory.sensitivity}`);
+    }
+    if (context.environment?.type !== 'development') {
+        contextFactors.push(`Environment: ${context.environment?.type}`);
+    }
+    // Check each mapping
+    for (const mapping of mappings) {
+        const match = command.match(mapping.pattern);
+        if (match) {
+            matchedPatterns.push(mapping.description);
+            const generatorContext = {
+                context,
+                match,
+                command,
+            };
+            try {
+                const suggestions = mapping.suggest(generatorContext);
+                alternatives.push(...suggestions);
+            }
+            catch (error) {
+                // Skip this mapping on error
+                console.error(`Error generating alternatives for ${mapping.description}:`, error);
+            }
+        }
+    }
+    // Filter by minimum safety improvement
+    alternatives = alternatives.filter(alt => alt.safetyImprovement >= opts.minSafetyImprovement);
+    // Check tool availability if requested
+    if (opts.checkToolAvailability) {
+        alternatives = alternatives.map(alt => {
+            if (alt.requiresTool && !isToolAvailable(alt.requiresTool)) {
+                return {
+                    ...alt,
+                    reason: `${alt.reason} (Requires installing ${alt.requiresTool})`,
+                };
+            }
+            return alt;
+        });
+    }
+    // Sort by safety improvement (highest first)
+    alternatives.sort((a, b) => b.safetyImprovement - a.safetyImprovement);
+    // Limit number of alternatives
+    alternatives = alternatives.slice(0, opts.maxAlternatives);
+    // Determine original risk level
+    const originalRisk = analysis?.risk || 'write';
+    return {
+        originalCommand: command,
+        originalRisk,
+        alternatives,
+        noAlternativesReason: alternatives.length === 0
+            ? 'No safer alternatives found for this command'
+            : undefined,
+        metadata: {
+            matchedPatterns,
+            contextFactors,
+        },
+    };
+}
+/**
+ * Check if a command-line tool is available.
+ */
+function isToolAvailable(toolName) {
+    try {
+        execSync(`which ${toolName}`, { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Format alternatives for display.
+ *
+ * @param result - Alternative result to format
+ * @returns Formatted string for terminal display
+ */
+export function formatAlternatives(result) {
+    if (result.alternatives.length === 0) {
+        return result.noAlternativesReason || 'No alternatives available';
+    }
+    const lines = [];
+    lines.push('Safer alternatives:');
+    lines.push('');
+    for (let i = 0; i < result.alternatives.length; i++) {
+        const alt = result.alternatives[i];
+        const num = i + 1;
+        const reversibleIcon = alt.reversible ? '↩' : '⚠';
+        lines.push(`  [${num}] ${alt.command}`);
+        lines.push(`      ${alt.reason}`);
+        lines.push(`      Safety: +${alt.safetyImprovement}% ${reversibleIcon} ${alt.reversible ? 'Reversible' : 'Not reversible'}`);
+        if (alt.requiresTool) {
+            lines.push(`      Requires: ${alt.requiresTool}`);
+            if (alt.installInstructions) {
+                lines.push(`      Install: ${alt.installInstructions}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Get the safest alternative if available.
+ */
+export function getSafestAlternative(result) {
+    if (result.alternatives.length === 0) {
+        return undefined;
+    }
+    // Already sorted by safety improvement
+    return result.alternatives[0];
+}
+/**
+ * Get only reversible alternatives.
+ */
+export function getReversibleAlternatives(result) {
+    return result.alternatives.filter(alt => alt.reversible);
+}
+/**
+ * Check if better alternatives exist (significant safety improvement).
+ */
+export function hasBetterAlternatives(result, minImprovement = 50) {
+    return result.alternatives.some(alt => alt.safetyImprovement >= minImprovement);
+}
+/**
+ * Create a summary of available alternatives.
+ */
+export function summarizeAlternatives(result) {
+    if (result.alternatives.length === 0) {
+        return 'No safer alternatives available';
+    }
+    const count = result.alternatives.length;
+    const safest = result.alternatives[0];
+    const reversibleCount = result.alternatives.filter(a => a.reversible).length;
+    return `${count} alternative${count > 1 ? 's' : ''} available. ` +
+        `Safest: "${safest.command}" (+${safest.safetyImprovement}% safer). ` +
+        `${reversibleCount} reversible.`;
+}
+/**
+ * AlternativesFinder class for stateful alternative finding.
+ */
+export class AlternativesFinder {
+    options;
+    toolCache = new Map();
+    constructor(options) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Find alternatives for a command.
+     */
+    find(command, context, analysis) {
+        return findAlternatives(command, context, analysis, this.options);
+    }
+    /**
+     * Check if a tool is available (cached).
+     */
+    isToolAvailable(toolName) {
+        if (this.toolCache.has(toolName)) {
+            return this.toolCache.get(toolName);
+        }
+        const available = isToolAvailable(toolName);
+        this.toolCache.set(toolName, available);
+        return available;
+    }
+    /**
+     * Get install instructions for missing tools.
+     */
+    getMissingToolInstructions(result) {
+        const missing = new Map();
+        for (const alt of result.alternatives) {
+            if (alt.requiresTool && !this.isToolAvailable(alt.requiresTool)) {
+                missing.set(alt.requiresTool, alt.installInstructions || `Install ${alt.requiresTool}`);
+            }
+        }
+        return missing;
+    }
+}
+/**
+ * Create an alternatives finder instance.
+ */
+export function createAlternativesFinder(options) {
+    return new AlternativesFinder(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/guard/alternatives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/guard/alternatives/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAS9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAYvD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE7E;;GAEG;AACH,MAAM,eAAe,GAA8B;IACjD,eAAe,EAAE,CAAC;IAClB,oBAAoB,EAAE,EAAE;IACxB,qBAAqB,EAAE,KAAK;CAC7B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,OAA6B,EAC7B,QAAyB,EACzB,OAA4C;IAE5C,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAC1C,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,YAAY,GAAuB,EAAE,CAAC;IAE1C,yBAAyB;IACzB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,cAAc,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QACxB,cAAc,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;YACtC,cAAc,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,cAAc,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;QAChD,cAAc,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,qBAAqB;IACrB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,KAAK,EAAE,CAAC;YACV,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAE1C,MAAM,gBAAgB,GAAgC;gBACpD,OAAO;gBACP,KAAK;gBACL,OAAO;aACR,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBACtD,YAAY,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,6BAA6B;gBAC7B,OAAO,CAAC,KAAK,CAAC,qCAAqC,OAAO,CAAC,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,YAAY,GAAG,YAAY,CAAC,MAAM,CAChC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,oBAAqB,CAC3D,CAAC;IAEF,uCAAuC;IACvC,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC/B,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACpC,IAAI,GAAG,CAAC,YAAY,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC3D,OAAO;oBACL,GAAG,GAAG;oBACN,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,yBAAyB,GAAG,CAAC,YAAY,GAAG;iBAClE,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAEvE,+BAA+B;IAC/B,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAE3D,gCAAgC;IAChC,MAAM,YAAY,GAAG,QAAQ,EAAE,IAAI,IAAI,OAAO,CAAC;IAE/C,OAAO;QACL,eAAe,EAAE,OAAO;QACxB,YAAY;QACZ,YAAY;QACZ,oBAAoB,EAAE,YAAY,CAAC,MAAM,KAAK,CAAC;YAC7C,CAAC,CAAC,8CAA8C;YAChD,CAAC,CAAC,SAAS;QACb,QAAQ,EAAE;YACR,eAAe;YACf,cAAc;SACf;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,CAAC;QACH,QAAQ,CAAC,SAAS,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,oBAAoB,IAAI,2BAA2B,CAAC;IACpE,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC;QACpC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAElD,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,CAAC,iBAAiB,KAAK,cAAc,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAE7H,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;YAClD,IAAI,GAAG,CAAC,mBAAmB,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAyB;IAC5D,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,uCAAuC;IACvC,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAyB;IACjE,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAyB,EACzB,cAAc,GAAG,EAAE;IAEnB,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,IAAI,cAAc,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAyB;IAC7D,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,iCAAiC,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC;IACvC,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IAE7E,OAAO,GAAG,KAAK,eAAe,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,cAAc;QAC9D,YAAY,MAAM,CAAC,OAAO,OAAO,MAAM,CAAC,iBAAiB,YAAY;QACrE,GAAG,eAAe,cAAc,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAA4B;IAC5C,SAAS,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEpD,YAAY,OAA4C;QACtD,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,IAAI,CACF,OAAe,EACf,OAA6B,EAC7B,QAAyB;QAEzB,OAAO,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,QAAgB;QAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QACvC,CAAC;QAED,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,0BAA0B,CAAC,MAAyB;QAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,GAAG,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChE,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,mBAAmB,IAAI,WAAW,GAAG,CAAC,YAAY,EAAE,CACzD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA4C;IAE5C,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/guard/alternatives/registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Alternatives Registry for Shell Guardian
+ *
+ * Comprehensive mapping of dangerous commands to safer alternatives.
+ */
+import type { AlternativeMapping } from './types.js';
+/**
+ * Registry of alternative command mappings.
+ * Sorted by priority (higher priority checked first).
+ */
+export declare const ALTERNATIVE_MAPPINGS: AlternativeMapping[];
+/**
+ * Get all alternative mappings sorted by priority.
+ */
+export declare function getAlternativeMappings(): AlternativeMapping[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/guard/alternatives/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/guard/alternatives/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAoB,MAAM,YAAY,CAAC;AAGvE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EA8hBpD,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,EAAE,CAI7D"}