@dotsetlabs/tollgate 0.2.2 → 0.3.0

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * Command Parser for Shell Guardian
+ *
+ * Parses shell commands into structured representations.
+ */
+import type { ParsedCommand } from './types.js';
+/**
+ * Parse a shell command into a structured representation.
+ *
+ * @param command - The command string to parse
+ * @returns Parsed command structure
+ */
+export declare function parseCommand(command: string): ParsedCommand;
+/**
+ * Check if command has a specific flag.
+ */
+export declare function hasFlag(parsed: ParsedCommand, flagName: string): boolean;
+/**
+ * Get flag value if present.
+ */
+export declare function getFlagValue(parsed: ParsedCommand, flagName: string): string | undefined;
+/**
+ * Check if command is recursive (based on common flags).
+ */
+export declare function isRecursive(parsed: ParsedCommand): boolean;
+/**
+ * Check if command has force flag.
+ */
+export declare function hasForceFlag(parsed: ParsedCommand): boolean;
+/**
+ * Get the full command with subcommand.
+ */
+export declare function getFullCommand(parsed: ParsedCommand): string;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/guard/preview/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAC;AAWtE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAc3D;AAgQD;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKxE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAK5D"}

package/dist/guard/preview/parser.js

@@ -0,0 +1,292 @@
+/**
+ * Command Parser for Shell Guardian
+ *
+ * Parses shell commands into structured representations.
+ */
+/**
+ * Commands that typically have subcommands.
+ */
+const SUBCOMMAND_COMMANDS = new Set([
+    'git', 'docker', 'kubectl', 'npm', 'yarn', 'pnpm', 'cargo', 'go',
+    'apt', 'apt-get', 'brew', 'pip', 'pip3', 'gem', 'bundle',
+    'systemctl', 'journalctl', 'service',
+]);
+/**
+ * Parse a shell command into a structured representation.
+ *
+ * @param command - The command string to parse
+ * @returns Parsed command structure
+ */
+export function parseCommand(command) {
+    const trimmed = command.trim();
+    // Handle pipes
+    const pipeSegments = splitOnPipes(trimmed);
+    if (pipeSegments.length > 1) {
+        // Parse first command and remaining as pipes
+        const first = parseSimpleCommand(pipeSegments[0]);
+        first.pipes = pipeSegments.slice(1).map(seg => parseSimpleCommand(seg));
+        return first;
+    }
+    return parseSimpleCommand(trimmed);
+}
+/**
+ * Split command on pipes, respecting quotes.
+ */
+function splitOnPipes(command) {
+    const segments = [];
+    let current = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let escape = false;
+    for (let i = 0; i < command.length; i++) {
+        const char = command[i];
+        if (escape) {
+            current += char;
+            escape = false;
+            continue;
+        }
+        if (char === '\\') {
+            escape = true;
+            current += char;
+            continue;
+        }
+        if (char === "'" && !inDoubleQuote) {
+            inSingleQuote = !inSingleQuote;
+            current += char;
+            continue;
+        }
+        if (char === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            current += char;
+            continue;
+        }
+        if (char === '|' && !inSingleQuote && !inDoubleQuote) {
+            segments.push(current.trim());
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim()) {
+        segments.push(current.trim());
+    }
+    return segments;
+}
+/**
+ * Parse a simple command (no pipes).
+ */
+function parseSimpleCommand(command) {
+    const tokens = tokenize(command);
+    const redirects = extractRedirects(tokens);
+    const filteredTokens = tokens.filter(t => !isRedirectToken(t));
+    // Check for sudo
+    let hasSudo = false;
+    let startIndex = 0;
+    if (filteredTokens[0] === 'sudo' || filteredTokens[0] === 'doas') {
+        hasSudo = true;
+        startIndex = 1;
+        // Skip sudo flags
+        while (startIndex < filteredTokens.length && filteredTokens[startIndex].startsWith('-')) {
+            startIndex++;
+        }
+    }
+    // Get executable
+    const executable = filteredTokens[startIndex] || '';
+    // Check for subcommand
+    let subcommand;
+    let argsStartIndex = startIndex + 1;
+    if (SUBCOMMAND_COMMANDS.has(executable) && filteredTokens[startIndex + 1]) {
+        const potentialSubcmd = filteredTokens[startIndex + 1];
+        if (!potentialSubcmd.startsWith('-')) {
+            subcommand = potentialSubcmd;
+            argsStartIndex = startIndex + 2;
+        }
+    }
+    // Parse flags and positional args
+    const flags = [];
+    const positionalArgs = [];
+    let i = argsStartIndex;
+    while (i < filteredTokens.length) {
+        const token = filteredTokens[i];
+        if (token === '--') {
+            // Everything after -- is positional
+            positionalArgs.push(...filteredTokens.slice(i + 1));
+            break;
+        }
+        if (token.startsWith('--')) {
+            // Long flag
+            const equalIndex = token.indexOf('=');
+            if (equalIndex !== -1) {
+                flags.push({
+                    name: token.slice(2, equalIndex),
+                    value: token.slice(equalIndex + 1),
+                    type: 'long',
+                });
+            }
+            else {
+                flags.push({
+                    name: token.slice(2),
+                    type: 'long',
+                });
+            }
+        }
+        else if (token.startsWith('-') && token.length > 1) {
+            // Short flag(s)
+            const flagChars = token.slice(1);
+            for (let j = 0; j < flagChars.length; j++) {
+                flags.push({
+                    name: flagChars[j],
+                    type: 'short',
+                });
+            }
+        }
+        else {
+            // Positional argument
+            positionalArgs.push(stripQuotes(token));
+        }
+        i++;
+    }
+    return {
+        executable,
+        subcommand,
+        flags,
+        positionalArgs,
+        pipes: [],
+        redirects,
+        original: command,
+        hasSudo,
+    };
+}
+/**
+ * Tokenize command string.
+ */
+function tokenize(command) {
+    const tokens = [];
+    let current = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let escape = false;
+    for (let i = 0; i < command.length; i++) {
+        const char = command[i];
+        if (escape) {
+            current += char;
+            escape = false;
+            continue;
+        }
+        if (char === '\\') {
+            escape = true;
+            current += char;
+            continue;
+        }
+        if (char === "'" && !inDoubleQuote) {
+            inSingleQuote = !inSingleQuote;
+            current += char;
+            continue;
+        }
+        if (char === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            current += char;
+            continue;
+        }
+        if (/\s/.test(char) && !inSingleQuote && !inDoubleQuote) {
+            if (current) {
+                tokens.push(current);
+                current = '';
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (current) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+/**
+ * Extract redirections from tokens.
+ */
+function extractRedirects(tokens) {
+    const redirects = [];
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token === '>' || token === '1>') {
+            if (tokens[i + 1]) {
+                redirects.push({ type: 'stdout', target: tokens[i + 1] });
+            }
+        }
+        else if (token === '>>') {
+            if (tokens[i + 1]) {
+                redirects.push({ type: 'append', target: tokens[i + 1] });
+            }
+        }
+        else if (token === '2>') {
+            if (tokens[i + 1]) {
+                redirects.push({ type: 'stderr', target: tokens[i + 1] });
+            }
+        }
+        else if (token === '<') {
+            if (tokens[i + 1]) {
+                redirects.push({ type: 'stdin', target: tokens[i + 1] });
+            }
+        }
+        else if (token.startsWith('>')) {
+            redirects.push({ type: 'stdout', target: token.slice(1) });
+        }
+        else if (token.startsWith('>>')) {
+            redirects.push({ type: 'append', target: token.slice(2) });
+        }
+    }
+    return redirects;
+}
+/**
+ * Check if a token is a redirect operator or target.
+ */
+function isRedirectToken(token) {
+    return /^[<>]|^[12]?>|^>>/.test(token);
+}
+/**
+ * Strip quotes from a string.
+ */
+function stripQuotes(str) {
+    if ((str.startsWith('"') && str.endsWith('"')) ||
+        (str.startsWith("'") && str.endsWith("'"))) {
+        return str.slice(1, -1);
+    }
+    return str;
+}
+/**
+ * Check if command has a specific flag.
+ */
+export function hasFlag(parsed, flagName) {
+    return parsed.flags.some(f => f.name === flagName ||
+        (f.type === 'short' && flagName.length === 1 && f.name === flagName));
+}
+/**
+ * Get flag value if present.
+ */
+export function getFlagValue(parsed, flagName) {
+    const flag = parsed.flags.find(f => f.name === flagName);
+    return flag?.value;
+}
+/**
+ * Check if command is recursive (based on common flags).
+ */
+export function isRecursive(parsed) {
+    return hasFlag(parsed, 'r') || hasFlag(parsed, 'R') || hasFlag(parsed, 'recursive');
+}
+/**
+ * Check if command has force flag.
+ */
+export function hasForceFlag(parsed) {
+    return hasFlag(parsed, 'f') || hasFlag(parsed, 'force');
+}
+/**
+ * Get the full command with subcommand.
+ */
+export function getFullCommand(parsed) {
+    if (parsed.subcommand) {
+        return `${parsed.executable} ${parsed.subcommand}`;
+    }
+    return parsed.executable;
+}
+//# sourceMappingURL=parser.js.map

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

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

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

@@ -0,0 +1,140 @@
+/**
+ * Types for Command Preview System
+ */
+/**
+ * Parsed command structure.
+ */
+export interface ParsedCommand {
+    /** The main executable/command */
+    executable: string;
+    /** Subcommand if applicable (e.g., 'commit' in 'git commit') */
+    subcommand?: string;
+    /** All flags/options */
+    flags: ParsedFlag[];
+    /** Positional arguments (non-flag arguments) */
+    positionalArgs: string[];
+    /** Piped commands */
+    pipes: ParsedCommand[];
+    /** Redirections */
+    redirects: Redirect[];
+    /** The original command string */
+    original: string;
+    /** Whether the command uses sudo */
+    hasSudo: boolean;
+}
+/**
+ * Parsed flag from command.
+ */
+export interface ParsedFlag {
+    /** Flag name (without dashes) */
+    name: string;
+    /** Flag value if any */
+    value?: string;
+    /** Whether it's a short flag (-f) or long flag (--flag) */
+    type: 'short' | 'long';
+}
+/**
+ * Redirection in command.
+ */
+export interface Redirect {
+    /** Type of redirection */
+    type: 'stdout' | 'stderr' | 'stdin' | 'append';
+    /** Target file/destination */
+    target: string;
+}
+/**
+ * Types of effects a command can have.
+ */
+export type EffectType = 'delete' | 'modify' | 'create' | 'read' | 'execute' | 'network' | 'permission' | 'process' | 'unknown';
+/**
+ * Confidence level of effect prediction.
+ */
+export type EffectConfidence = 'certain' | 'likely' | 'possible';
+/**
+ * Effect a command will have.
+ */
+export interface CommandEffect {
+    /** Type of effect */
+    type: EffectType;
+    /** Target paths/items */
+    targets: string[];
+    /** Expanded targets from globs */
+    expandedTargets?: string[];
+    /** Confidence in this effect */
+    confidence: EffectConfidence;
+    /** Description of the effect */
+    description: string;
+    /** Whether this effect is recursive */
+    recursive?: boolean;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Impact assessment of a command.
+ */
+export interface ImpactAssessment {
+    /** Number of files affected */
+    filesAffected: number;
+    /** Number of directories affected */
+    directoriesAffected: number;
+    /** Total bytes affected (if calculable) */
+    bytesAffected?: number;
+    /** Human-readable summary */
+    summary: string;
+    /** Breakdown by file extension */
+    byExtension?: Record<string, number>;
+    /** Breakdown by effect type */
+    byEffectType?: Record<EffectType, number>;
+    /** Whether the impact is fully known */
+    isComplete: boolean;
+    /** If not complete, why */
+    incompleteReason?: string;
+}
+/**
+ * Complete preview of a command.
+ */
+export interface CommandPreview {
+    /** Parsed command structure */
+    parsed: ParsedCommand;
+    /** Predicted effects */
+    effects: CommandEffect[];
+    /** Impact assessment */
+    impact: ImpactAssessment;
+    /** Time to generate preview in ms */
+    generationTimeMs: number;
+    /** Warnings during preview generation */
+    warnings?: string[];
+}
+/**
+ * Options for preview generation.
+ */
+export interface PreviewOptions {
+    /** Maximum files to expand from globs */
+    maxExpandedFiles?: number;
+    /** Maximum depth for recursive operations */
+    maxDepth?: number;
+    /** Timeout for expansion operations in ms */
+    expansionTimeout?: number;
+    /** Whether to calculate sizes */
+    calculateSizes?: boolean;
+    /** Current working directory */
+    cwd?: string;
+}
+/**
+ * Known command effects.
+ */
+export interface CommandEffectPattern {
+    /** Effect type */
+    type: EffectType;
+    /** Which positional args are targets (true = all, number[] = specific indices) */
+    targetArgs: true | number[];
+    /** Whether operation is recursive by default */
+    recursive?: boolean;
+    /** Flags that make it recursive */
+    recursiveFlags?: string[];
+    /** Flags that change the effect type */
+    effectModifiers?: Record<string, EffectType>;
+    /** Description template */
+    description: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/guard/preview/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for Command Preview System
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/guard/preview/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,88 @@
+/**
+ * Reversibility Analyzer for Shell Guardian
+ *
+ * Assesses whether the effects of a command can be undone.
+ */
+import type { CommandEffect } from '../preview/types.js';
+import type { EnhancedGuardContext } from '../context/types.js';
+/**
+ * Reversibility level of a command.
+ */
+export type ReversibilityLevel = 'fully-reversible' | 'partially-reversible' | 'difficult-to-reverse' | 'irreversible';
+/**
+ * Factor affecting reversibility.
+ */
+export interface ReversibilityFactor {
+    /** Description of the factor */
+    factor: string;
+    /** Whether it increases or decreases reversibility */
+    impact: 'increases' | 'decreases';
+    /** Detailed explanation */
+    details: string;
+    /** Weight of this factor (0-1) */
+    weight: number;
+}
+/**
+ * Assessment of command reversibility.
+ */
+export interface ReversibilityAssessment {
+    /** Overall reversibility level */
+    level: ReversibilityLevel;
+    /** Overall reversibility score (0-100) */
+    score: number;
+    /** Human-readable reason */
+    reason: string;
+    /** Instructions to reverse if possible */
+    reverseInstructions?: string;
+    /** What would be lost if not reversed */
+    potentialLoss?: string;
+    /** Factors that influenced the assessment */
+    factors: ReversibilityFactor[];
+    /** Files that can be recovered */
+    recoverableFiles?: string[];
+    /** Files that cannot be recovered */
+    unrecoverableFiles?: string[];
+}
+/**
+ * Assess reversibility of a command based on its effects.
+ *
+ * @param command - The original command
+ * @param effects - Analyzed command effects
+ * @param context - Enhanced guard context
+ * @returns Reversibility assessment
+ */
+export declare function assessReversibility(command: string, effects: CommandEffect[], context: EnhancedGuardContext): ReversibilityAssessment;
+/**
+ * Get icon for reversibility level.
+ */
+export declare function getReversibilityIcon(level: ReversibilityLevel): string;
+/**
+ * Get color for reversibility level (for terminal display).
+ */
+export declare function getReversibilityColor(level: ReversibilityLevel): 'green' | 'yellow' | 'red';
+/**
+ * Format reversibility assessment for display.
+ */
+export declare function formatReversibility(assessment: ReversibilityAssessment): string;
+/**
+ * Check if operation requires extra warning based on reversibility.
+ */
+export declare function requiresReversibilityWarning(assessment: ReversibilityAssessment): boolean;
+/**
+ * ReversibilityAnalyzer class for stateful analysis.
+ */
+export declare class ReversibilityAnalyzer {
+    /**
+     * Assess reversibility of a command.
+     */
+    assess(command: string, effects: CommandEffect[], context: EnhancedGuardContext): ReversibilityAssessment;
+    /**
+     * Quick check if operation is reversible.
+     */
+    isReversible(effects: CommandEffect[], context: EnhancedGuardContext): boolean;
+}
+/**
+ * Create a reversibility analyzer.
+ */
+export declare function createReversibilityAnalyzer(): ReversibilityAnalyzer;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/guard/reversibility/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIhE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,sBAAsB,GACtB,sBAAsB,GACtB,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IAClC,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,EAAE,oBAAoB,GAC5B,uBAAuB,CAuEzB;AAmMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAOtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAO3F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,CAgB/E;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAEzF;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,EAAE,oBAAoB,GAC5B,uBAAuB;IAI1B;;OAEG;IACH,YAAY,CACV,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,EAAE,oBAAoB,GAC5B,OAAO;CAIX;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE"}