@dotsetlabs/tollgate 0.2.2 → 0.3.0

package/dist/guard/learning/index.js

@@ -0,0 +1,314 @@
+/**
+ * Pattern Learning System for Shell Guardian
+ *
+ * Records approval decisions and learns patterns to suggest
+ * policy improvements over time.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_LEARNING_CONFIG } from './types.js';
+import { extractPattern, groupByPattern, buildLearnedPatterns } from './pattern-extractor.js';
+import { analyzeAndSuggest, formatSuggestions, exportSuggestionsAsYaml, findRefinementOpportunities, } from './rule-suggester.js';
+export { DEFAULT_LEARNING_CONFIG } from './types.js';
+// Re-export functions
+export { extractPattern, groupByPattern, buildLearnedPatterns, patternSimilarity, findSimilarPatterns, } from './pattern-extractor.js';
+export { analyzeAndSuggest, formatSuggestions, exportSuggestionsAsYaml, suggestionToRule, findRefinementOpportunities, } from './rule-suggester.js';
+/**
+ * Default storage path for learning data.
+ */
+const DEFAULT_STORAGE_PATH = join(homedir(), '.config', 'tollgate', 'learning.json');
+/**
+ * JSON file-based learning storage.
+ */
+export class JsonLearningStorage {
+    path;
+    data;
+    constructor(path = DEFAULT_STORAGE_PATH) {
+        this.path = path;
+        this.data = this.load();
+    }
+    /**
+     * Load data from file.
+     */
+    load() {
+        try {
+            if (existsSync(this.path)) {
+                const content = readFileSync(this.path, 'utf-8');
+                return JSON.parse(content);
+            }
+        }
+        catch {
+            // File doesn't exist or is invalid, start fresh
+        }
+        return {
+            version: 1,
+            records: [],
+            suggestions: [],
+        };
+    }
+    /**
+     * Save data to file.
+     */
+    save() {
+        const dir = dirname(this.path);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.path, JSON.stringify(this.data, null, 2));
+    }
+    async saveRecord(record) {
+        this.data.records.push(record);
+        this.save();
+    }
+    async getRecords(options) {
+        let records = [...this.data.records];
+        if (options?.since) {
+            const since = options.since.getTime();
+            records = records.filter(r => new Date(r.timestamp).getTime() >= since);
+        }
+        if (options?.until) {
+            const until = options.until.getTime();
+            records = records.filter(r => new Date(r.timestamp).getTime() <= until);
+        }
+        if (options?.decision) {
+            records = records.filter(r => r.decision === options.decision);
+        }
+        if (options?.limit) {
+            records = records.slice(0, options.limit);
+        }
+        return records;
+    }
+    async getRecordsByPattern(pattern) {
+        return this.data.records.filter(r => r.normalizedPattern === pattern);
+    }
+    async saveSuggestion(suggestion) {
+        // Remove existing suggestion for same pattern
+        this.data.suggestions = this.data.suggestions.filter(s => s.rule.pattern !== suggestion.rule.pattern);
+        this.data.suggestions.push(suggestion);
+        this.save();
+    }
+    async getSuggestions() {
+        return [...this.data.suggestions];
+    }
+    async updateSuggestion(id, update) {
+        const index = this.data.suggestions.findIndex(s => s.id === id);
+        if (index !== -1) {
+            this.data.suggestions[index] = { ...this.data.suggestions[index], ...update };
+            this.save();
+        }
+    }
+    async clear() {
+        this.data = {
+            version: 1,
+            records: [],
+            suggestions: [],
+        };
+        this.save();
+    }
+    async getStats() {
+        const records = this.data.records;
+        const byDecision = {};
+        for (const r of records) {
+            byDecision[r.decision] = (byDecision[r.decision] || 0) + 1;
+        }
+        const uniquePatterns = new Set(records.map(r => r.normalizedPattern)).size;
+        const activeSuggestions = this.data.suggestions.filter(s => !s.dismissed && !s.accepted).length;
+        const sorted = [...records].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        return {
+            totalRecords: records.length,
+            byDecision,
+            uniquePatterns,
+            activeSuggestions,
+            oldestRecord: sorted[0] ? new Date(sorted[0].timestamp) : undefined,
+            newestRecord: sorted[sorted.length - 1]
+                ? new Date(sorted[sorted.length - 1].timestamp)
+                : undefined,
+        };
+    }
+}
+/**
+ * Learning Engine for Shell Guardian.
+ *
+ * Manages recording of approval decisions and generation
+ * of rule suggestions based on learned patterns.
+ */
+export class LearningEngine {
+    storage;
+    config;
+    recordStartTime;
+    constructor(storage, config = {}) {
+        this.storage = storage || new JsonLearningStorage();
+        this.config = { ...DEFAULT_LEARNING_CONFIG, ...config };
+    }
+    /**
+     * Start timing a decision.
+     * Call this when showing the approval prompt.
+     */
+    startDecisionTimer() {
+        if (this.config.trackDecisionTime) {
+            this.recordStartTime = Date.now();
+        }
+    }
+    /**
+     * Record an approval decision.
+     *
+     * @param command - The command that was evaluated
+     * @param decision - The user's decision
+     * @param context - Enhanced guard context
+     * @param options - Additional options
+     */
+    async record(command, decision, context, options) {
+        const decisionTimeMs = this.recordStartTime
+            ? Date.now() - this.recordStartTime
+            : undefined;
+        const record = {
+            id: randomUUID(),
+            command,
+            normalizedPattern: extractPattern(command),
+            decision,
+            timestamp: new Date(),
+            decisionTimeMs,
+            context: {
+                projectType: context.project?.type,
+                cwd: context.cwd || process.cwd(),
+                riskLevel: options.riskLevel,
+                isGitRepo: context.git?.isRepo,
+                hadUncommittedChanges: context.git?.hasUncommittedChanges,
+                directorySensitivity: context.directory?.sensitivity,
+                environment: context.environment?.type,
+            },
+            chosenAlternative: options.chosenAlternative,
+            sessionGrant: options.sessionGrant,
+        };
+        await this.storage.saveRecord(record);
+        this.recordStartTime = undefined;
+    }
+    /**
+     * Get all approval records.
+     */
+    async getRecords(options) {
+        return this.storage.getRecords(options);
+    }
+    /**
+     * Get learned patterns from history.
+     */
+    async getLearnedPatterns() {
+        const records = await this.storage.getRecords();
+        const groups = groupByPattern(records);
+        return buildLearnedPatterns(groups);
+    }
+    /**
+     * Generate rule suggestions based on learned patterns.
+     */
+    async generateSuggestions(existingConfig) {
+        const records = await this.storage.getRecords();
+        const analysis = analyzeAndSuggest(records, existingConfig, this.config);
+        // Save suggestions to storage
+        for (const suggestion of analysis.suggestions) {
+            await this.storage.saveSuggestion(suggestion);
+        }
+        return analysis.suggestions;
+    }
+    /**
+     * Get existing suggestions.
+     */
+    async getSuggestions() {
+        return this.storage.getSuggestions();
+    }
+    /**
+     * Accept a suggestion.
+     */
+    async acceptSuggestion(id) {
+        await this.storage.updateSuggestion(id, { accepted: true });
+    }
+    /**
+     * Dismiss a suggestion.
+     */
+    async dismissSuggestion(id) {
+        await this.storage.updateSuggestion(id, { dismissed: true });
+    }
+    /**
+     * Get learning statistics.
+     */
+    async getStats() {
+        return this.storage.getStats();
+    }
+    /**
+     * Clear all learning data.
+     */
+    async clear() {
+        await this.storage.clear();
+    }
+    /**
+     * Export suggestions as YAML for config.
+     */
+    async exportSuggestionsYaml() {
+        const suggestions = await this.storage.getSuggestions();
+        const active = suggestions.filter(s => !s.dismissed && !s.accepted);
+        return exportSuggestionsAsYaml(active);
+    }
+    /**
+     * Format suggestions for display.
+     */
+    async formatSuggestions() {
+        const suggestions = await this.storage.getSuggestions();
+        const active = suggestions.filter(s => !s.dismissed && !s.accepted);
+        return formatSuggestions(active);
+    }
+    /**
+     * Get refinement opportunities.
+     */
+    async getRefinementOpportunities() {
+        const patterns = await this.getLearnedPatterns();
+        return findRefinementOpportunities(patterns);
+    }
+}
+/**
+ * Create a learning engine with default storage.
+ */
+export function createLearningEngine(config) {
+    return new LearningEngine(undefined, config);
+}
+/**
+ * Create a learning engine with custom storage path.
+ */
+export function createLearningEngineWithPath(storagePath, config) {
+    const storage = new JsonLearningStorage(storagePath);
+    return new LearningEngine(storage, config);
+}
+/**
+ * Format learning stats for display.
+ */
+export function formatLearningStats(stats) {
+    const lines = [
+        'Shell Guardian Learning Statistics',
+        '─'.repeat(40),
+        '',
+        `Total decisions recorded: ${stats.totalRecords}`,
+        `Unique command patterns: ${stats.uniquePatterns}`,
+        `Active suggestions: ${stats.activeSuggestions}`,
+        '',
+        'Decisions by type:',
+    ];
+    for (const [decision, count] of Object.entries(stats.byDecision)) {
+        const pct = stats.totalRecords > 0
+            ? Math.round((count / stats.totalRecords) * 100)
+            : 0;
+        lines.push(`  ${decision}: ${count} (${pct}%)`);
+    }
+    if (stats.oldestRecord) {
+        lines.push('');
+        lines.push(`Recording since: ${stats.oldestRecord.toLocaleDateString()}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Quick check if there's enough data for suggestions.
+ */
+export async function hasEnoughDataForSuggestions(engine, minRecords = 10) {
+    const stats = await engine.getStats();
+    return stats.totalRecords >= minRecords;
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/guard/learning/pattern-extractor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Pattern Extractor for Shell Guardian Learning System
+ *
+ * Extracts normalizable patterns from commands to identify
+ * similar command structures across different arguments.
+ */
+import type { ApprovalRecord, LearnedPattern } from './types.js';
+/**
+ * Extract a normalized pattern from a command.
+ *
+ * Examples:
+ *   "rm -rf node_modules" → "rm -rf <directory>"
+ *   "npm install lodash" → "npm install <package>"
+ *   "git commit -m 'fix bug'" → "git commit -m <message>"
+ *   "cat /etc/passwd" → "cat <path>"
+ *
+ * @param command - The command to extract pattern from
+ * @returns Normalized pattern string
+ */
+export declare function extractPattern(command: string): string;
+/**
+ * Group approval records by their extracted pattern.
+ *
+ * @param records - Approval records to group
+ * @returns Map of pattern to records
+ */
+export declare function groupByPattern(records: ApprovalRecord[]): Map<string, ApprovalRecord[]>;
+/**
+ * Build learned patterns from grouped records.
+ *
+ * @param groups - Grouped records by pattern
+ * @returns Array of learned patterns
+ */
+export declare function buildLearnedPatterns(groups: Map<string, ApprovalRecord[]>): LearnedPattern[];
+/**
+ * Calculate similarity between two patterns.
+ *
+ * @param pattern1 - First pattern
+ * @param pattern2 - Second pattern
+ * @returns Similarity score (0-1)
+ */
+export declare function patternSimilarity(pattern1: string, pattern2: string): number;
+/**
+ * Find similar patterns in a list.
+ */
+export declare function findSimilarPatterns(target: string, patterns: string[], threshold?: number): Array<{
+    pattern: string;
+    similarity: number;
+}>;
+//# sourceMappingURL=pattern-extractor.d.ts.map

package/dist/guard/learning/pattern-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-extractor.d.ts","sourceRoot":"","sources":["../../../src/guard/learning/pattern-extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AA8GxF;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0EtD;AAkFD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAWvF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,GACpC,cAAc,EAAE,CAiElB;AAgCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyB5E;AASD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,SAAM,GACd,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAYhD"}