@dotsetlabs/tollgate 0.2.2 → 0.3.0

package/dist/guard/learning/rule-suggester.js

@@ -0,0 +1,345 @@
+/**
+ * Rule Suggester for Shell Guardian Learning System
+ *
+ * Analyzes approval history and learned patterns to suggest
+ * policy rules that would automate common decisions.
+ */
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_LEARNING_CONFIG } from './types.js';
+import { groupByPattern, buildLearnedPatterns } from './pattern-extractor.js';
+/**
+ * Analyze approval history and suggest rules.
+ *
+ * @param records - Approval history records
+ * @param existingConfig - Current guard config (to avoid duplicate rules)
+ * @param config - Learning configuration
+ * @returns Analysis result with suggestions
+ */
+export function analyzeAndSuggest(records, existingConfig, config = DEFAULT_LEARNING_CONFIG) {
+    // Filter out old records
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - config.maxRecordAgeDays);
+    const recentRecords = records.filter(r => new Date(r.timestamp) >= cutoff);
+    // Group by pattern and build learned patterns
+    const groups = groupByPattern(recentRecords);
+    const learnedPatterns = buildLearnedPatterns(groups);
+    const suggestions = [];
+    const insufficientData = [];
+    const inconsistent = [];
+    // Get existing rule patterns to avoid duplicates
+    const existingPatterns = new Set();
+    if (existingConfig?.rules) {
+        for (const rule of existingConfig.rules) {
+            existingPatterns.add(rule.pattern);
+        }
+    }
+    for (const pattern of learnedPatterns) {
+        // Skip if already has a rule
+        if (existingPatterns.has(pattern.pattern)) {
+            continue;
+        }
+        // Check if enough data
+        if (pattern.frequency < config.minOccurrences) {
+            insufficientData.push({
+                pattern: pattern.pattern,
+                occurrences: pattern.frequency,
+                needed: config.minOccurrences,
+            });
+            continue;
+        }
+        // Check for consistent approval (suggest allow rule)
+        if (pattern.approvalRate >= config.minApprovalRateForAllow) {
+            const suggestion = createAllowSuggestion(pattern, config);
+            if (suggestion && suggestion.confidence >= config.minConfidence) {
+                suggestions.push(suggestion);
+            }
+            continue;
+        }
+        // Check for consistent denial (suggest deny rule)
+        if (pattern.approvalRate <= config.maxApprovalRateForDeny) {
+            const suggestion = createDenySuggestion(pattern, config);
+            if (suggestion && suggestion.confidence >= config.minConfidence) {
+                suggestions.push(suggestion);
+            }
+            continue;
+        }
+        // Pattern is inconsistent - record for analysis
+        inconsistent.push({
+            pattern: pattern.pattern,
+            approvalRate: pattern.approvalRate,
+            denialRate: pattern.denialRate,
+        });
+    }
+    // Sort suggestions by confidence
+    suggestions.sort((a, b) => b.confidence - a.confidence);
+    return {
+        suggestions,
+        insufficientData,
+        inconsistent,
+        stats: {
+            patternsAnalyzed: learnedPatterns.length,
+            suggestionsGenerated: suggestions.length,
+            highConfidenceSuggestions: suggestions.filter(s => s.confidence >= 0.9).length,
+        },
+    };
+}
+/**
+ * Create an allow suggestion from a pattern.
+ */
+function createAllowSuggestion(pattern, config) {
+    // Calculate confidence based on multiple factors
+    let confidence = 0;
+    // Base confidence from approval rate
+    confidence += pattern.approvalRate * 0.4;
+    // Confidence boost from sample size
+    const sampleBoost = Math.min(pattern.frequency / 20, 0.3);
+    confidence += sampleBoost;
+    // Confidence boost from consistency (low timeout rate)
+    if (pattern.timeoutRate < 0.1) {
+        confidence += 0.1;
+    }
+    // Confidence boost if decisions were quick (users were confident)
+    if (pattern.avgDecisionTimeMs && pattern.avgDecisionTimeMs < 5000) {
+        confidence += 0.1;
+    }
+    // Reduce confidence if alternatives were often chosen
+    if (pattern.contextSummary.alternativeChoiceRate > 0.3) {
+        confidence -= 0.2;
+    }
+    confidence = Math.min(1, Math.max(0, confidence));
+    if (confidence < config.minConfidence) {
+        return null;
+    }
+    const rule = {
+        pattern: pattern.pattern,
+        action: 'allow',
+        reason: `Automatically approved ${Math.round(pattern.approvalRate * 100)}% of the time`,
+    };
+    // Add conditions if pattern is context-specific
+    const dominantProjectType = getDominantContextValue(pattern.contextSummary.projectTypes);
+    if (dominantProjectType && dominantProjectType.percentage > 0.8) {
+        rule.conditions = {
+            ...rule.conditions,
+            projectTypes: [dominantProjectType.value],
+        };
+    }
+    return {
+        id: randomUUID(),
+        rule,
+        reason: buildSuggestionReason(pattern, 'allow'),
+        basedOn: pattern,
+        confidence,
+        generatedAt: new Date(),
+    };
+}
+/**
+ * Create a deny suggestion from a pattern.
+ */
+function createDenySuggestion(pattern, config) {
+    // Calculate confidence
+    let confidence = 0;
+    // Base confidence from denial rate
+    confidence += pattern.denialRate * 0.4;
+    // Confidence boost from sample size
+    const sampleBoost = Math.min(pattern.frequency / 20, 0.3);
+    confidence += sampleBoost;
+    // Confidence boost from consistency
+    if (pattern.timeoutRate < 0.1) {
+        confidence += 0.1;
+    }
+    confidence = Math.min(1, Math.max(0, confidence));
+    if (confidence < config.minConfidence) {
+        return null;
+    }
+    const rule = {
+        pattern: pattern.pattern,
+        action: 'deny',
+        reason: `Consistently denied (${Math.round(pattern.denialRate * 100)}% denial rate)`,
+    };
+    return {
+        id: randomUUID(),
+        rule,
+        reason: buildSuggestionReason(pattern, 'deny'),
+        basedOn: pattern,
+        confidence,
+        generatedAt: new Date(),
+    };
+}
+/**
+ * Get the dominant value from a frequency map.
+ */
+function getDominantContextValue(map) {
+    const entries = Object.entries(map);
+    if (entries.length === 0)
+        return null;
+    const total = entries.reduce((sum, [, count]) => sum + count, 0);
+    const sorted = entries.sort((a, b) => b[1] - a[1]);
+    const [topValue, topCount] = sorted[0];
+    return {
+        value: topValue,
+        percentage: topCount / total,
+    };
+}
+/**
+ * Build a human-readable reason for a suggestion.
+ */
+function buildSuggestionReason(pattern, action) {
+    const parts = [];
+    if (action === 'allow') {
+        parts.push(`This command pattern was approved ${Math.round(pattern.approvalRate * 100)}% ` +
+            `of the time across ${pattern.frequency} occurrences.`);
+    }
+    else {
+        parts.push(`This command pattern was denied ${Math.round(pattern.denialRate * 100)}% ` +
+            `of the time across ${pattern.frequency} occurrences.`);
+    }
+    // Add context details
+    const dominantProject = getDominantContextValue(pattern.contextSummary.projectTypes);
+    if (dominantProject && dominantProject.value !== 'unknown') {
+        parts.push(`Primarily used in ${dominantProject.value} projects.`);
+    }
+    // Add timing info
+    if (pattern.avgDecisionTimeMs) {
+        if (pattern.avgDecisionTimeMs < 3000) {
+            parts.push('Users decided quickly, suggesting high confidence.');
+        }
+        else if (pattern.avgDecisionTimeMs > 10000) {
+            parts.push('Users took time to decide, suggesting careful consideration needed.');
+        }
+    }
+    // Add alternative info
+    if (pattern.contextSummary.alternativeChoiceRate > 0.2) {
+        parts.push(`Note: Users chose alternatives ${Math.round(pattern.contextSummary.alternativeChoiceRate * 100)}% of the time.`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Convert a rule suggestion to a guard rule.
+ */
+export function suggestionToRule(suggestion) {
+    // Build reason string that includes condition info
+    let reason = suggestion.rule.reason || suggestion.reason;
+    if (suggestion.rule.conditions) {
+        const conditions = [];
+        if (suggestion.rule.conditions.projectTypes) {
+            conditions.push(`projects: ${suggestion.rule.conditions.projectTypes.join(', ')}`);
+        }
+        if (suggestion.rule.conditions.riskLevels) {
+            conditions.push(`risks: ${suggestion.rule.conditions.riskLevels.join(', ')}`);
+        }
+        if (suggestion.rule.conditions.directoryPatterns) {
+            conditions.push(`dirs: ${suggestion.rule.conditions.directoryPatterns.join(', ')}`);
+        }
+        if (conditions.length > 0) {
+            reason = `${reason} (${conditions.join('; ')})`;
+        }
+    }
+    return {
+        pattern: suggestion.rule.pattern,
+        action: suggestion.rule.action,
+        reason,
+    };
+}
+/**
+ * Format suggestions for display.
+ */
+export function formatSuggestions(suggestions) {
+    if (suggestions.length === 0) {
+        return 'No rule suggestions available. Keep using Shell Guardian to build up approval history.';
+    }
+    const lines = [
+        `Found ${suggestions.length} rule suggestion${suggestions.length > 1 ? 's' : ''}:`,
+        '',
+    ];
+    for (let i = 0; i < suggestions.length; i++) {
+        const s = suggestions[i];
+        const conf = Math.round(s.confidence * 100);
+        const action = s.rule.action.toUpperCase();
+        lines.push(`${i + 1}. [${action}] ${s.rule.pattern}`);
+        lines.push(`   Confidence: ${conf}% | Based on ${s.basedOn.frequency} occurrences`);
+        lines.push(`   ${s.reason}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Export suggestions as YAML rules.
+ */
+export function exportSuggestionsAsYaml(suggestions) {
+    const lines = [
+        '# Auto-generated rules from Shell Guardian learning',
+        `# Generated: ${new Date().toISOString()}`,
+        '',
+        'rules:',
+    ];
+    for (const suggestion of suggestions) {
+        const rule = suggestionToRule(suggestion);
+        lines.push(`  - pattern: "${rule.pattern}"`);
+        lines.push(`    action: ${rule.action}`);
+        lines.push(`    reason: "${rule.reason}"`);
+        lines.push(`    # Confidence: ${Math.round(suggestion.confidence * 100)}%`);
+        lines.push(`    # Based on ${suggestion.basedOn.frequency} occurrences`);
+        // Add conditions as comments for reference
+        if (suggestion.rule.conditions) {
+            if (suggestion.rule.conditions.projectTypes) {
+                lines.push(`    # Project types: ${suggestion.rule.conditions.projectTypes.join(', ')}`);
+            }
+            if (suggestion.rule.conditions.riskLevels) {
+                lines.push(`    # Risk levels: ${suggestion.rule.conditions.riskLevels.join(', ')}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Merge suggestions with existing config.
+ */
+export function mergeSuggestionsWithConfig(suggestions, config) {
+    const newRules = suggestions.map(suggestionToRule);
+    return {
+        ...config,
+        rules: [
+            ...(config.rules || []),
+            ...newRules,
+        ],
+    };
+}
+/**
+ * Find patterns that might benefit from more specific rules.
+ */
+export function findRefinementOpportunities(patterns) {
+    const opportunities = [];
+    for (const pattern of patterns) {
+        // Check for patterns with high alternative choice rate
+        if (pattern.contextSummary.alternativeChoiceRate > 0.5) {
+            opportunities.push({
+                pattern: pattern.pattern,
+                reason: `Users chose alternatives ${Math.round(pattern.contextSummary.alternativeChoiceRate * 100)}% of the time`,
+                suggestion: 'Consider using the safer alternative as the default',
+            });
+        }
+        // Check for patterns with long decision times
+        if (pattern.avgDecisionTimeMs && pattern.avgDecisionTimeMs > 15000) {
+            opportunities.push({
+                pattern: pattern.pattern,
+                reason: `Average decision time is ${Math.round(pattern.avgDecisionTimeMs / 1000)}s`,
+                suggestion: 'Consider adding more context or explanation for this command',
+            });
+        }
+        // Check for patterns that vary by project type
+        const projectTypes = Object.keys(pattern.contextSummary.projectTypes);
+        if (projectTypes.length > 1) {
+            const dominant = getDominantContextValue(pattern.contextSummary.projectTypes);
+            if (dominant && dominant.percentage < 0.6) {
+                opportunities.push({
+                    pattern: pattern.pattern,
+                    reason: 'Behavior varies significantly by project type',
+                    suggestion: 'Consider creating project-specific rules',
+                });
+            }
+        }
+    }
+    return opportunities;
+}
+//# sourceMappingURL=rule-suggester.js.map

package/dist/guard/learning/rule-suggester.js.map

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

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

@@ -0,0 +1,211 @@
+/**
+ * Types for Shell Guardian Pattern Learning System
+ *
+ * Records user approval decisions and extracts patterns
+ * to suggest policy improvements over time.
+ */
+import type { RiskLevel } from '../../analyzers/types.js';
+import type { GuardAction } from '../types.js';
+/**
+ * Record of a single approval decision.
+ */
+export interface ApprovalRecord {
+    /** Unique ID for this record */
+    id: string;
+    /** The original command */
+    command: string;
+    /** Normalized pattern extracted from command */
+    normalizedPattern: string;
+    /** The user's decision */
+    decision: 'approved' | 'denied' | 'timeout';
+    /** Timestamp of the decision */
+    timestamp: Date;
+    /** Duration user took to decide (ms) */
+    decisionTimeMs?: number;
+    /** Context at time of decision */
+    context: ApprovalContext;
+    /** If user chose an alternative */
+    chosenAlternative?: string;
+    /** Session grant if approved with remember */
+    sessionGrant?: {
+        scope: string;
+        duration: string;
+    };
+}
+/**
+ * Context captured with an approval record.
+ */
+export interface ApprovalContext {
+    /** Project type if detected */
+    projectType?: string;
+    /** Working directory */
+    cwd: string;
+    /** Risk level assigned */
+    riskLevel: RiskLevel;
+    /** Whether in git repo */
+    isGitRepo?: boolean;
+    /** Whether had uncommitted changes */
+    hadUncommittedChanges?: boolean;
+    /** Directory sensitivity score */
+    directorySensitivity?: number;
+    /** Environment type */
+    environment?: string;
+}
+/**
+ * A pattern learned from approval history.
+ */
+export interface LearnedPattern {
+    /** The normalized pattern */
+    pattern: string;
+    /** Number of times this pattern occurred */
+    frequency: number;
+    /** Approval rate (0-1) */
+    approvalRate: number;
+    /** Denial rate (0-1) */
+    denialRate: number;
+    /** Timeout rate (0-1) */
+    timeoutRate: number;
+    /** Suggested action based on history */
+    suggestedAction: GuardAction;
+    /** Confidence in suggestion (0-1) */
+    confidence: number;
+    /** Example commands that matched this pattern */
+    examples: string[];
+    /** Average decision time for this pattern */
+    avgDecisionTimeMs?: number;
+    /** Last occurrence */
+    lastSeen: Date;
+    /** First occurrence */
+    firstSeen: Date;
+    /** Contexts where this pattern appeared */
+    contextSummary: PatternContextSummary;
+}
+/**
+ * Summary of contexts where a pattern appeared.
+ */
+export interface PatternContextSummary {
+    /** Project types where this pattern was used */
+    projectTypes: Record<string, number>;
+    /** Risk levels assigned to this pattern */
+    riskLevels: Record<RiskLevel, number>;
+    /** How often alternatives were chosen */
+    alternativeChoiceRate: number;
+}
+/**
+ * A suggested rule based on learned patterns.
+ */
+export interface RuleSuggestion {
+    /** Unique ID for this suggestion */
+    id: string;
+    /** The suggested rule */
+    rule: SuggestedRule;
+    /** Why this rule is being suggested */
+    reason: string;
+    /** The learned pattern this is based on */
+    basedOn: LearnedPattern;
+    /** Confidence in this suggestion (0-1) */
+    confidence: number;
+    /** When this suggestion was generated */
+    generatedAt: Date;
+    /** Whether user has dismissed this suggestion */
+    dismissed?: boolean;
+    /** Whether user has accepted this suggestion */
+    accepted?: boolean;
+}
+/**
+ * A rule suggested by the learning system.
+ */
+export interface SuggestedRule {
+    /** Pattern to match */
+    pattern: string;
+    /** Suggested action */
+    action: GuardAction;
+    /** Optional reason to show user */
+    reason?: string;
+    /** Conditions for the rule */
+    conditions?: SuggestedRuleConditions;
+}
+/**
+ * Conditions for a suggested rule.
+ */
+export interface SuggestedRuleConditions {
+    /** Only apply in these project types */
+    projectTypes?: string[];
+    /** Only apply at these risk levels */
+    riskLevels?: RiskLevel[];
+    /** Only apply in certain directories */
+    directoryPatterns?: string[];
+}
+/**
+ * Storage interface for learning data.
+ */
+export interface LearningStorage {
+    /** Save an approval record */
+    saveRecord(record: ApprovalRecord): Promise<void>;
+    /** Get all records */
+    getRecords(options?: GetRecordsOptions): Promise<ApprovalRecord[]>;
+    /** Get records matching a pattern */
+    getRecordsByPattern(pattern: string): Promise<ApprovalRecord[]>;
+    /** Save a rule suggestion */
+    saveSuggestion(suggestion: RuleSuggestion): Promise<void>;
+    /** Get all suggestions */
+    getSuggestions(): Promise<RuleSuggestion[]>;
+    /** Update suggestion status */
+    updateSuggestion(id: string, update: Partial<RuleSuggestion>): Promise<void>;
+    /** Clear all learning data */
+    clear(): Promise<void>;
+    /** Get statistics */
+    getStats(): Promise<LearningStats>;
+}
+/**
+ * Options for getting records.
+ */
+export interface GetRecordsOptions {
+    /** Only get records after this date */
+    since?: Date;
+    /** Only get records before this date */
+    until?: Date;
+    /** Maximum number of records */
+    limit?: number;
+    /** Only get records with this decision */
+    decision?: 'approved' | 'denied' | 'timeout';
+}
+/**
+ * Statistics about learning data.
+ */
+export interface LearningStats {
+    /** Total records */
+    totalRecords: number;
+    /** Records by decision */
+    byDecision: Record<string, number>;
+    /** Unique patterns */
+    uniquePatterns: number;
+    /** Active suggestions */
+    activeSuggestions: number;
+    /** Date of oldest record */
+    oldestRecord?: Date;
+    /** Date of newest record */
+    newestRecord?: Date;
+}
+/**
+ * Configuration for the learning engine.
+ */
+export interface LearningConfig {
+    /** Minimum occurrences before suggesting a rule */
+    minOccurrences: number;
+    /** Minimum approval rate to suggest allow */
+    minApprovalRateForAllow: number;
+    /** Maximum approval rate to suggest deny */
+    maxApprovalRateForDeny: number;
+    /** Minimum confidence to suggest a rule */
+    minConfidence: number;
+    /** Maximum age of records to consider (days) */
+    maxRecordAgeDays: number;
+    /** Whether to track decision times */
+    trackDecisionTime: boolean;
+}
+/**
+ * Default learning configuration.
+ */
+export declare const DEFAULT_LEARNING_CONFIG: LearningConfig;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/guard/learning/types.js

@@ -0,0 +1,18 @@
+/**
+ * Types for Shell Guardian Pattern Learning System
+ *
+ * Records user approval decisions and extracts patterns
+ * to suggest policy improvements over time.
+ */
+/**
+ * Default learning configuration.
+ */
+export const DEFAULT_LEARNING_CONFIG = {
+    minOccurrences: 3,
+    minApprovalRateForAllow: 0.9,
+    maxApprovalRateForDeny: 0.1,
+    minConfidence: 0.7,
+    maxRecordAgeDays: 90,
+    trackDecisionTime: true,
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/guard/learning/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsNH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,cAAc,EAAE,CAAC;IACjB,uBAAuB,EAAE,GAAG;IAC5B,sBAAsB,EAAE,GAAG;IAC3B,aAAa,EAAE,GAAG;IAClB,gBAAgB,EAAE,EAAE;IACpB,iBAAiB,EAAE,IAAI;CACxB,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Effect Analyzer for Shell Guardian
+ *
+ * Analyzes what effects a command will have.
+ */
+import type { CommandEffect, ParsedCommand, ImpactAssessment, PreviewOptions } from './types.js';
+/**
+ * Analyze effects of a parsed command.
+ */
+export declare function analyzeEffects(parsed: ParsedCommand, options?: Partial<PreviewOptions>): Promise<CommandEffect[]>;
+/**
+ * Calculate impact assessment from effects.
+ */
+export declare function calculateImpact(effects: CommandEffect[], options?: Partial<PreviewOptions>): ImpactAssessment;
+//# sourceMappingURL=effects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../../src/guard/preview/effects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACV,aAAa,EAGb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAC;AAoKpB;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,aAAa,EAAE,CAAC,CA6F1B;AA4ED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,gBAAgB,CA4ElB"}