@dotsetlabs/tollgate 0.2.2 → 0.3.0

package/dist/guard/preview/effects.js

@@ -0,0 +1,413 @@
+/**
+ * Effect Analyzer for Shell Guardian
+ *
+ * Analyzes what effects a command will have.
+ */
+import { existsSync, statSync, readdirSync } from 'node:fs';
+import { resolve, basename } from 'node:path';
+import fg from 'fast-glob';
+import { hasFlag } from './parser.js';
+/**
+ * Known command effect patterns.
+ */
+const COMMAND_EFFECTS = {
+    // File operations
+    rm: {
+        type: 'delete',
+        targetArgs: true,
+        recursiveFlags: ['r', 'R'],
+        description: 'Delete files/directories',
+    },
+    rmdir: {
+        type: 'delete',
+        targetArgs: true,
+        description: 'Remove empty directories',
+    },
+    unlink: {
+        type: 'delete',
+        targetArgs: true,
+        description: 'Remove file',
+    },
+    // Move/Copy
+    mv: {
+        type: 'modify',
+        targetArgs: true,
+        description: 'Move/rename files',
+    },
+    cp: {
+        type: 'create',
+        targetArgs: [1], // Destination is target
+        recursiveFlags: ['r', 'R'],
+        description: 'Copy files',
+    },
+    // Create
+    touch: {
+        type: 'create',
+        targetArgs: true,
+        description: 'Create/update files',
+    },
+    mkdir: {
+        type: 'create',
+        targetArgs: true,
+        description: 'Create directories',
+    },
+    // Read
+    cat: {
+        type: 'read',
+        targetArgs: true,
+        description: 'Display file contents',
+    },
+    less: {
+        type: 'read',
+        targetArgs: true,
+        description: 'View file contents',
+    },
+    head: {
+        type: 'read',
+        targetArgs: true,
+        description: 'View start of file',
+    },
+    tail: {
+        type: 'read',
+        targetArgs: true,
+        description: 'View end of file',
+    },
+    grep: {
+        type: 'read',
+        targetArgs: true,
+        description: 'Search file contents',
+    },
+    // Permissions
+    chmod: {
+        type: 'permission',
+        targetArgs: true,
+        recursiveFlags: ['R'],
+        description: 'Change file permissions',
+    },
+    chown: {
+        type: 'permission',
+        targetArgs: true,
+        recursiveFlags: ['R'],
+        description: 'Change file ownership',
+    },
+    // Network
+    curl: {
+        type: 'network',
+        targetArgs: false,
+        description: 'HTTP request',
+    },
+    wget: {
+        type: 'network',
+        targetArgs: false,
+        description: 'Download file',
+    },
+    // Process
+    kill: {
+        type: 'process',
+        targetArgs: true,
+        description: 'Terminate process',
+    },
+    killall: {
+        type: 'process',
+        targetArgs: true,
+        description: 'Terminate processes by name',
+    },
+    pkill: {
+        type: 'process',
+        targetArgs: true,
+        description: 'Terminate processes by pattern',
+    },
+};
+/**
+ * Git command effects.
+ */
+const GIT_EFFECTS = {
+    rm: {
+        type: 'delete',
+        targetArgs: true,
+        recursiveFlags: ['r'],
+        description: 'Remove files from git',
+    },
+    clean: {
+        type: 'delete',
+        targetArgs: false,
+        description: 'Remove untracked files',
+    },
+    checkout: {
+        type: 'modify',
+        targetArgs: true,
+        description: 'Checkout files/branches',
+    },
+    reset: {
+        type: 'modify',
+        targetArgs: true,
+        effectModifiers: { hard: 'delete' },
+        description: 'Reset state',
+    },
+    add: {
+        type: 'modify',
+        targetArgs: true,
+        description: 'Stage files',
+    },
+};
+/**
+ * Default preview options.
+ */
+const DEFAULT_OPTIONS = {
+    maxExpandedFiles: 100,
+    maxDepth: 5,
+    expansionTimeout: 5000,
+    calculateSizes: true,
+};
+/**
+ * Analyze effects of a parsed command.
+ */
+export async function analyzeEffects(parsed, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const cwd = opts.cwd || process.cwd();
+    const effects = [];
+    // Get effect pattern for command
+    let effectPattern;
+    if (parsed.executable === 'git' && parsed.subcommand) {
+        effectPattern = GIT_EFFECTS[parsed.subcommand];
+    }
+    else {
+        effectPattern = COMMAND_EFFECTS[parsed.executable];
+    }
+    if (!effectPattern) {
+        // Unknown command
+        effects.push({
+            type: 'unknown',
+            targets: parsed.positionalArgs,
+            confidence: 'possible',
+            description: `Unknown effect for: ${parsed.executable}`,
+        });
+        return effects;
+    }
+    // Determine targets
+    let targets = [];
+    if (effectPattern.targetArgs === true) {
+        targets = parsed.positionalArgs;
+    }
+    else if (Array.isArray(effectPattern.targetArgs)) {
+        targets = effectPattern.targetArgs
+            .filter(i => i < parsed.positionalArgs.length)
+            .map(i => parsed.positionalArgs[i]);
+    }
+    // Resolve and expand targets
+    const resolvedTargets = targets.map(t => {
+        if (t.startsWith('/'))
+            return t;
+        return resolve(cwd, t);
+    });
+    // Check for recursive flag
+    const recursive = effectPattern.recursiveFlags?.some(f => hasFlag(parsed, f)) || false;
+    // Expand globs and collect affected files
+    const expandedTargets = await expandTargets(resolvedTargets, recursive, opts);
+    // Determine actual effect type
+    let effectType = effectPattern.type;
+    if (effectPattern.effectModifiers) {
+        for (const [flag, newType] of Object.entries(effectPattern.effectModifiers)) {
+            if (hasFlag(parsed, flag)) {
+                effectType = newType;
+            }
+        }
+    }
+    effects.push({
+        type: effectType,
+        targets: resolvedTargets,
+        expandedTargets: expandedTargets.files,
+        confidence: expandedTargets.truncated ? 'likely' : 'certain',
+        description: effectPattern.description,
+        recursive,
+        metadata: {
+            totalFiles: expandedTargets.total,
+            truncated: expandedTargets.truncated,
+        },
+    });
+    // Check for redirects creating files
+    for (const redirect of parsed.redirects) {
+        if (redirect.type === 'stdout' || redirect.type === 'append') {
+            effects.push({
+                type: 'create',
+                targets: [redirect.target],
+                confidence: 'certain',
+                description: `${redirect.type === 'append' ? 'Append to' : 'Write to'} file`,
+            });
+        }
+    }
+    // Analyze piped commands
+    for (const piped of parsed.pipes) {
+        const pipedEffects = await analyzeEffects(piped, opts);
+        effects.push(...pipedEffects);
+    }
+    return effects;
+}
+/**
+ * Expand glob patterns and directory contents.
+ */
+async function expandTargets(targets, recursive, options) {
+    const files = [];
+    let total = 0;
+    let truncated = false;
+    for (const target of targets) {
+        // Check if it's a glob pattern
+        if (target.includes('*') || target.includes('?') || target.includes('[')) {
+            try {
+                const matches = await fg.glob(target, {
+                    cwd: options.cwd || process.cwd(),
+                    absolute: true,
+                    onlyFiles: false,
+                    deep: options.maxDepth,
+                });
+                total += matches.length;
+                if (files.length < options.maxExpandedFiles) {
+                    const remaining = options.maxExpandedFiles - files.length;
+                    files.push(...matches.slice(0, remaining));
+                    if (matches.length > remaining) {
+                        truncated = true;
+                    }
+                }
+                else {
+                    truncated = true;
+                }
+            }
+            catch {
+                files.push(target);
+                total++;
+            }
+        }
+        else if (existsSync(target)) {
+            const stat = statSync(target);
+            if (stat.isDirectory() && recursive) {
+                // Expand directory contents
+                try {
+                    const contents = readdirSync(target, { recursive: true });
+                    total += contents.length;
+                    if (files.length < options.maxExpandedFiles) {
+                        const remaining = options.maxExpandedFiles - files.length;
+                        files.push(...contents.slice(0, remaining).map(f => resolve(target, f)));
+                        if (contents.length > remaining) {
+                            truncated = true;
+                        }
+                    }
+                    else {
+                        truncated = true;
+                    }
+                }
+                catch {
+                    files.push(target);
+                    total++;
+                }
+            }
+            else {
+                files.push(target);
+                total++;
+            }
+        }
+        else {
+            // Target doesn't exist yet (might be created)
+            files.push(target);
+            total++;
+        }
+    }
+    return { files, total, truncated };
+}
+/**
+ * Calculate impact assessment from effects.
+ */
+export function calculateImpact(effects, options) {
+    let filesAffected = 0;
+    let directoriesAffected = 0;
+    let bytesAffected;
+    const byExtension = {};
+    const byEffectType = {};
+    let isComplete = true;
+    let incompleteReason;
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    for (const effect of effects) {
+        // Count by effect type
+        byEffectType[effect.type] = (byEffectType[effect.type] || 0) + 1;
+        const targets = effect.expandedTargets || effect.targets;
+        for (const target of targets) {
+            try {
+                if (existsSync(target)) {
+                    const stat = statSync(target);
+                    if (stat.isDirectory()) {
+                        directoriesAffected++;
+                    }
+                    else {
+                        filesAffected++;
+                        // Count by extension
+                        const ext = getExtension(target);
+                        byExtension[ext] = (byExtension[ext] || 0) + 1;
+                        // Calculate size if requested
+                        if (opts.calculateSizes) {
+                            bytesAffected = (bytesAffected || 0) + stat.size;
+                        }
+                    }
+                }
+                else {
+                    // Target doesn't exist (will be created or is a pattern)
+                    filesAffected++;
+                }
+            }
+            catch {
+                filesAffected++;
+            }
+        }
+        // Check if results were truncated
+        if (effect.metadata?.truncated) {
+            isComplete = false;
+            incompleteReason = `Results truncated at ${opts.maxExpandedFiles} files`;
+        }
+    }
+    // Generate summary
+    const parts = [];
+    if (filesAffected > 0) {
+        parts.push(`${filesAffected} file${filesAffected > 1 ? 's' : ''}`);
+    }
+    if (directoriesAffected > 0) {
+        parts.push(`${directoriesAffected} director${directoriesAffected > 1 ? 'ies' : 'y'}`);
+    }
+    if (bytesAffected !== undefined) {
+        parts.push(`(${formatBytes(bytesAffected)})`);
+    }
+    const summary = parts.length > 0
+        ? `Affects ${parts.join(', ')}`
+        : 'No files affected';
+    return {
+        filesAffected,
+        directoriesAffected,
+        bytesAffected,
+        summary,
+        byExtension: Object.keys(byExtension).length > 0 ? byExtension : undefined,
+        byEffectType: Object.keys(byEffectType).length > 0 ? byEffectType : undefined,
+        isComplete,
+        incompleteReason,
+    };
+}
+/**
+ * Get file extension.
+ */
+function getExtension(path) {
+    const name = basename(path);
+    const dotIndex = name.lastIndexOf('.');
+    if (dotIndex === -1 || dotIndex === 0) {
+        return '(no extension)';
+    }
+    return name.slice(dotIndex);
+}
+/**
+ * Format bytes to human-readable string.
+ */
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+//# sourceMappingURL=effects.js.map

package/dist/guard/preview/effects.js.map

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

package/dist/guard/preview/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Command Preview System for Shell Guardian
+ *
+ * Generates previews of what commands will do before execution.
+ */
+import type { CommandPreview, PreviewOptions } from './types.js';
+export type { CommandPreview, PreviewOptions, ParsedCommand, ParsedFlag, Redirect, CommandEffect, EffectType, EffectConfidence, ImpactAssessment, CommandEffectPattern, } from './types.js';
+export { parseCommand, hasFlag, isRecursive, hasForceFlag, getFullCommand, getFlagValue, } from './parser.js';
+export { analyzeEffects, calculateImpact, } from './effects.js';
+/**
+ * Generate a preview of what a command will do.
+ *
+ * @param command - The command string
+ * @param options - Preview options
+ * @returns Command preview with effects and impact assessment
+ */
+export declare function generatePreview(command: string, options?: Partial<PreviewOptions>): Promise<CommandPreview>;
+/**
+ * Format preview for terminal display.
+ */
+export declare function formatPreview(preview: CommandPreview): string;
+/**
+ * Check if preview indicates dangerous operation.
+ */
+export declare function isDangerousPreview(preview: CommandPreview): boolean;
+/**
+ * Get summary of preview for quick display.
+ */
+export declare function getPreviewSummary(preview: CommandPreview): string;
+/**
+ * PreviewGenerator class for stateful preview generation.
+ */
+export declare class PreviewGenerator {
+    private readonly options;
+    constructor(options?: Partial<PreviewOptions>);
+    /**
+     * Generate preview for a command.
+     */
+    generate(command: string): Promise<CommandPreview>;
+    /**
+     * Generate quick summary without full expansion.
+     */
+    generateQuick(command: string): Promise<string>;
+}
+/**
+ * Create a preview generator.
+ */
+export declare function createPreviewGenerator(options?: Partial<PreviewOptions>): PreviewGenerator;
+//# sourceMappingURL=index.d.ts.map

package/dist/guard/preview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/guard/preview/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAEf,MAAM,YAAY,CAAC;AAKpB,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,UAAU,EACV,QAAQ,EACR,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,OAAO,EACP,WAAW,EACX,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AAYtB;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC,CAgCzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA0E7D;AAmBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAyBnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAKjE;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAI7C;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,gBAAgB,CAE1F"}

package/dist/guard/preview/index.js

@@ -0,0 +1,196 @@
+/**
+ * Command Preview System for Shell Guardian
+ *
+ * Generates previews of what commands will do before execution.
+ */
+import { parseCommand, isRecursive } from './parser.js';
+import { analyzeEffects, calculateImpact } from './effects.js';
+// Re-export utilities
+export { parseCommand, hasFlag, isRecursive, hasForceFlag, getFullCommand, getFlagValue, } from './parser.js';
+export { analyzeEffects, calculateImpact, } from './effects.js';
+/**
+ * Default preview options.
+ */
+const DEFAULT_OPTIONS = {
+    maxExpandedFiles: 100,
+    maxDepth: 5,
+    expansionTimeout: 5000,
+    calculateSizes: true,
+};
+/**
+ * Generate a preview of what a command will do.
+ *
+ * @param command - The command string
+ * @param options - Preview options
+ * @returns Command preview with effects and impact assessment
+ */
+export async function generatePreview(command, options) {
+    const startTime = Date.now();
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const warnings = [];
+    // Parse command
+    const parsed = parseCommand(command);
+    // Analyze effects
+    let effects;
+    try {
+        effects = await analyzeEffects(parsed, opts);
+    }
+    catch (error) {
+        warnings.push(`Error analyzing effects: ${error}`);
+        effects = [{
+                type: 'unknown',
+                targets: parsed.positionalArgs,
+                confidence: 'possible',
+                description: 'Could not analyze command effects',
+            }];
+    }
+    // Calculate impact
+    const impact = calculateImpact(effects, opts);
+    return {
+        parsed,
+        effects,
+        impact,
+        generationTimeMs: Date.now() - startTime,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Format preview for terminal display.
+ */
+export function formatPreview(preview) {
+    const lines = [];
+    lines.push('Command Preview');
+    lines.push('─'.repeat(50));
+    lines.push('');
+    // Command breakdown
+    lines.push(`Command: ${preview.parsed.executable}${preview.parsed.subcommand ? ' ' + preview.parsed.subcommand : ''}`);
+    if (preview.parsed.hasSudo) {
+        lines.push('  ⚠ Running with elevated privileges (sudo)');
+    }
+    if (preview.parsed.flags.length > 0) {
+        const flags = preview.parsed.flags.map(f => f.type === 'short' ? `-${f.name}` : `--${f.name}${f.value ? '=' + f.value : ''}`);
+        lines.push(`  Flags: ${flags.join(' ')}`);
+    }
+    if (preview.parsed.positionalArgs.length > 0) {
+        lines.push(`  Targets: ${preview.parsed.positionalArgs.join(', ')}`);
+    }
+    lines.push('');
+    // Effects
+    lines.push('Effects:');
+    for (const effect of preview.effects) {
+        const icon = getEffectIcon(effect.type);
+        const confidence = effect.confidence === 'certain' ? '' : ` (${effect.confidence})`;
+        lines.push(`  ${icon} ${effect.description}${confidence}`);
+        // Show affected items
+        const targets = effect.expandedTargets || effect.targets;
+        const showCount = Math.min(5, targets.length);
+        for (let i = 0; i < showCount; i++) {
+            lines.push(`     • ${targets[i]}`);
+        }
+        if (targets.length > showCount) {
+            lines.push(`     ... and ${targets.length - showCount} more`);
+        }
+    }
+    lines.push('');
+    // Impact summary
+    lines.push('Impact:');
+    lines.push(`  ${preview.impact.summary}`);
+    if (preview.impact.byExtension && Object.keys(preview.impact.byExtension).length > 0) {
+        const extSummary = Object.entries(preview.impact.byExtension)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([ext, count]) => `${ext}: ${count}`)
+            .join(', ');
+        lines.push(`  By type: ${extSummary}`);
+    }
+    if (!preview.impact.isComplete) {
+        lines.push(`  ⚠ ${preview.impact.incompleteReason}`);
+    }
+    lines.push('');
+    // Warnings
+    if (preview.warnings?.length) {
+        lines.push('Warnings:');
+        for (const warning of preview.warnings) {
+            lines.push(`  ⚠ ${warning}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Get icon for effect type.
+ */
+function getEffectIcon(type) {
+    switch (type) {
+        case 'delete': return '🗑️';
+        case 'modify': return '✏️';
+        case 'create': return '📄';
+        case 'read': return '👁️';
+        case 'execute': return '⚡';
+        case 'network': return '🌐';
+        case 'permission': return '🔒';
+        case 'process': return '⚙️';
+        default: return '❓';
+    }
+}
+/**
+ * Check if preview indicates dangerous operation.
+ */
+export function isDangerousPreview(preview) {
+    // Check for deletion of many files
+    if (preview.effects.some(e => e.type === 'delete' &&
+        (e.expandedTargets?.length || e.targets.length) > 10)) {
+        return true;
+    }
+    // Check for sudo delete
+    if (preview.parsed.hasSudo && preview.effects.some(e => e.type === 'delete')) {
+        return true;
+    }
+    // Check for recursive delete
+    if (isRecursive(preview.parsed) && preview.effects.some(e => e.type === 'delete')) {
+        return true;
+    }
+    // Check for large byte impact
+    if (preview.impact.bytesAffected && preview.impact.bytesAffected > 100 * 1024 * 1024) {
+        return true; // > 100MB
+    }
+    return false;
+}
+/**
+ * Get summary of preview for quick display.
+ */
+export function getPreviewSummary(preview) {
+    const effectTypes = [...new Set(preview.effects.map(e => e.type))];
+    const effectSummary = effectTypes.map(t => getEffectIcon(t)).join(' ');
+    return `${effectSummary} ${preview.impact.summary}`;
+}
+/**
+ * PreviewGenerator class for stateful preview generation.
+ */
+export class PreviewGenerator {
+    options;
+    constructor(options) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Generate preview for a command.
+     */
+    async generate(command) {
+        return generatePreview(command, this.options);
+    }
+    /**
+     * Generate quick summary without full expansion.
+     */
+    async generateQuick(command) {
+        const quickOpts = { ...this.options, maxExpandedFiles: 10 };
+        const preview = await generatePreview(command, quickOpts);
+        return getPreviewSummary(preview);
+    }
+}
+/**
+ * Create a preview generator.
+ */
+export function createPreviewGenerator(options) {
+    return new PreviewGenerator(options);
+}
+//# sourceMappingURL=index.js.map