@rangerchaz/aimem 0.1.4 → 0.2.0

package/dist/guardrails/analyzer.js

@@ -0,0 +1,329 @@
+/**
+ * Pattern Analyzer
+ *
+ * Scans the codebase and infers guardrails from patterns.
+ * This is the "onboarding" for a new project.
+ */
+import { getAllProjectStructures, insertGuardrail, incrementDikCounter } from '../db/index.js';
+/**
+ * Analyze a project and propose guardrails based on detected patterns.
+ */
+export function analyzeProject(projectId, options = {}) {
+    const categories = options.categories || ['architecture', 'naming', 'testing', 'security'];
+    const structures = getAllProjectStructures(projectId);
+    const proposed = [];
+    if (structures.length === 0) {
+        return proposed;
+    }
+    for (const category of categories) {
+        switch (category) {
+            case 'architecture':
+                proposed.push(...analyzeArchitecture(structures));
+                break;
+            case 'naming':
+                proposed.push(...analyzeNaming(structures));
+                break;
+            case 'testing':
+                proposed.push(...analyzeTesting(structures));
+                break;
+            case 'security':
+                proposed.push(...analyzeSecurity(structures));
+                break;
+        }
+    }
+    return proposed;
+}
+/**
+ * Save proposed rules as inferred guardrails.
+ */
+export function saveProposedRules(projectId, rules) {
+    const saved = [];
+    for (const rule of rules) {
+        const guardrail = insertGuardrail(projectId, rule.category, rule.rule, rule.rationale, 'warn', 'inferred', rule.evidence[0] || null);
+        saved.push(guardrail);
+        incrementDikCounter(projectId, 'rules_inferred');
+    }
+    return saved;
+}
+// ============ Category-specific analyzers ============
+/**
+ * Analyze architecture patterns.
+ * - Directory conventions
+ * - File type locations
+ * - Module structure
+ */
+function analyzeArchitecture(structures) {
+    const proposed = [];
+    // Group files by directory
+    const dirPatterns = new Map();
+    for (const s of structures) {
+        const parts = s.file_path.split('/');
+        if (parts.length > 1) {
+            const dir = parts.slice(0, -1).join('/');
+            if (!dirPatterns.has(dir)) {
+                dirPatterns.set(dir, new Set());
+            }
+            dirPatterns.get(dir).add(s.type);
+        }
+    }
+    // Detect directory type conventions
+    const typesByDir = new Map();
+    for (const s of structures) {
+        const parts = s.file_path.split('/');
+        if (parts.length > 1) {
+            const dir = parts[parts.length - 2]; // Immediate parent dir
+            if (!typesByDir.has(dir)) {
+                typesByDir.set(dir, { types: new Map(), files: [] });
+            }
+            const data = typesByDir.get(dir);
+            data.types.set(s.type, (data.types.get(s.type) || 0) + 1);
+            if (!data.files.includes(s.file_path)) {
+                data.files.push(s.file_path);
+            }
+        }
+    }
+    // Find directories with consistent patterns
+    for (const [dir, data] of typesByDir) {
+        const total = Array.from(data.types.values()).reduce((a, b) => a + b, 0);
+        for (const [type, count] of data.types) {
+            const ratio = count / total;
+            if (ratio > 0.7 && count >= 3) {
+                proposed.push({
+                    category: 'architecture',
+                    rule: `${type}s belong in the \`${dir}/\` directory`,
+                    rationale: `${Math.round(ratio * 100)}% of structures in ${dir}/ are ${type}s`,
+                    confidence: ratio,
+                    evidence: data.files.slice(0, 3),
+                });
+            }
+        }
+    }
+    return proposed;
+}
+/**
+ * Analyze naming patterns.
+ * - Case conventions
+ * - Prefix/suffix patterns
+ * - File naming
+ */
+function analyzeNaming(structures) {
+    const proposed = [];
+    // Analyze function naming conventions
+    const functions = structures.filter(s => s.type === 'function' || s.type === 'method');
+    if (functions.length >= 5) {
+        const casePatterns = detectCasePatterns(functions.map(f => f.name));
+        if (casePatterns.dominant && casePatterns.ratio > 0.7) {
+            proposed.push({
+                category: 'naming',
+                rule: `Functions use ${casePatterns.dominant} naming`,
+                rationale: `${Math.round(casePatterns.ratio * 100)}% of functions follow this pattern`,
+                confidence: casePatterns.ratio,
+                evidence: functions.slice(0, 3).map(f => f.file_path),
+            });
+        }
+    }
+    // Analyze class naming conventions
+    const classes = structures.filter(s => s.type === 'class');
+    if (classes.length >= 3) {
+        const casePatterns = detectCasePatterns(classes.map(c => c.name));
+        if (casePatterns.dominant && casePatterns.ratio > 0.8) {
+            proposed.push({
+                category: 'naming',
+                rule: `Classes use ${casePatterns.dominant} naming`,
+                rationale: `${Math.round(casePatterns.ratio * 100)}% of classes follow this pattern`,
+                confidence: casePatterns.ratio,
+                evidence: classes.slice(0, 3).map(c => c.file_path),
+            });
+        }
+    }
+    // Detect common prefixes
+    const prefixGroups = detectPrefixes(functions.map(f => f.name));
+    for (const [prefix, data] of prefixGroups) {
+        if (data.count >= 5 && prefix.length >= 2) {
+            proposed.push({
+                category: 'naming',
+                rule: `Functions that ${describePrefix(prefix)} should start with \`${prefix}\``,
+                rationale: `${data.count} functions use the ${prefix} prefix`,
+                confidence: 0.6,
+                evidence: data.examples.slice(0, 3),
+            });
+        }
+    }
+    return proposed;
+}
+/**
+ * Analyze testing patterns.
+ * - Test file locations
+ * - Test naming
+ * - Setup/teardown patterns
+ */
+function analyzeTesting(structures) {
+    const proposed = [];
+    // Find test files
+    const testFiles = new Set();
+    const testPatterns = new Map();
+    for (const s of structures) {
+        const path = s.file_path.toLowerCase();
+        if (path.includes('test') || path.includes('spec')) {
+            testFiles.add(s.file_path);
+            // Detect test location pattern
+            if (path.includes('__tests__')) {
+                testPatterns.set('__tests__/', (testPatterns.get('__tests__/') || 0) + 1);
+            }
+            else if (path.includes('/test/')) {
+                testPatterns.set('test/', (testPatterns.get('test/') || 0) + 1);
+            }
+            else if (path.includes('/tests/')) {
+                testPatterns.set('tests/', (testPatterns.get('tests/') || 0) + 1);
+            }
+            else if (path.includes('.test.') || path.includes('.spec.')) {
+                testPatterns.set('colocated', (testPatterns.get('colocated') || 0) + 1);
+            }
+        }
+    }
+    // Find dominant test location pattern
+    let maxPattern = '';
+    let maxCount = 0;
+    for (const [pattern, count] of testPatterns) {
+        if (count > maxCount) {
+            maxPattern = pattern;
+            maxCount = count;
+        }
+    }
+    if (maxCount >= 3 && testFiles.size > 0) {
+        const rule = maxPattern === 'colocated'
+            ? 'Tests are colocated with source files (*.test.* or *.spec.*)'
+            : `Tests belong in the \`${maxPattern}\` directory`;
+        proposed.push({
+            category: 'testing',
+            rule,
+            rationale: `${maxCount} test files follow this pattern`,
+            confidence: maxCount / testFiles.size,
+            evidence: Array.from(testFiles).slice(0, 3),
+        });
+    }
+    return proposed;
+}
+/**
+ * Analyze security patterns.
+ * - Auth patterns
+ * - Input validation
+ * - Secrets handling
+ */
+function analyzeSecurity(structures) {
+    const proposed = [];
+    // Look for auth middleware patterns
+    const authPatterns = structures.filter(s => {
+        const name = s.name.toLowerCase();
+        const content = s.raw_content.toLowerCase();
+        return name.includes('auth') || name.includes('middleware') ||
+            content.includes('authenticate') || content.includes('authorize');
+    });
+    if (authPatterns.length >= 2) {
+        proposed.push({
+            category: 'security',
+            rule: 'Authentication must use the established auth middleware pattern',
+            rationale: `Found ${authPatterns.length} auth-related structures to match`,
+            confidence: 0.7,
+            evidence: authPatterns.slice(0, 3).map(s => s.file_path),
+        });
+    }
+    // Look for validation patterns
+    const validationPatterns = structures.filter(s => {
+        const name = s.name.toLowerCase();
+        const content = s.raw_content.toLowerCase();
+        return name.includes('validat') || name.includes('sanitiz') ||
+            content.includes('validate') || content.includes('sanitize');
+    });
+    if (validationPatterns.length >= 3) {
+        proposed.push({
+            category: 'security',
+            rule: 'User input must be validated using the existing validation patterns',
+            rationale: `Found ${validationPatterns.length} validation structures`,
+            confidence: 0.6,
+            evidence: validationPatterns.slice(0, 3).map(s => s.file_path),
+        });
+    }
+    return proposed;
+}
+// ============ Helper functions ============
+function detectCasePatterns(names) {
+    const patterns = {
+        camelCase: 0,
+        snake_case: 0,
+        PascalCase: 0,
+        'kebab-case': 0,
+    };
+    for (const name of names) {
+        if (/^[a-z][a-zA-Z0-9]*$/.test(name) && /[A-Z]/.test(name)) {
+            patterns.camelCase++;
+        }
+        else if (/^[a-z][a-z0-9_]*$/.test(name) && name.includes('_')) {
+            patterns.snake_case++;
+        }
+        else if (/^[A-Z][a-zA-Z0-9]*$/.test(name)) {
+            patterns.PascalCase++;
+        }
+        else if (/^[a-z][a-z0-9-]*$/.test(name) && name.includes('-')) {
+            patterns['kebab-case']++;
+        }
+    }
+    let dominant = null;
+    let maxCount = 0;
+    for (const [pattern, count] of Object.entries(patterns)) {
+        if (count > maxCount) {
+            dominant = pattern;
+            maxCount = count;
+        }
+    }
+    return {
+        dominant,
+        ratio: names.length > 0 ? maxCount / names.length : 0,
+    };
+}
+function detectPrefixes(names) {
+    const prefixes = new Map();
+    const commonPrefixes = ['get', 'set', 'is', 'has', 'can', 'should', 'create', 'delete', 'update', 'fetch', 'load', 'save', 'find', 'handle', 'on', 'use'];
+    for (const name of names) {
+        for (const prefix of commonPrefixes) {
+            if (name.toLowerCase().startsWith(prefix) && name.length > prefix.length) {
+                const nextChar = name[prefix.length];
+                // Check if it's a proper prefix (followed by uppercase or underscore)
+                if (nextChar === nextChar.toUpperCase() || nextChar === '_') {
+                    if (!prefixes.has(prefix)) {
+                        prefixes.set(prefix, { count: 0, examples: [] });
+                    }
+                    const data = prefixes.get(prefix);
+                    data.count++;
+                    if (data.examples.length < 5) {
+                        data.examples.push(name);
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    return prefixes;
+}
+function describePrefix(prefix) {
+    const descriptions = {
+        get: 'retrieve data',
+        set: 'set values',
+        is: 'check boolean conditions',
+        has: 'check existence',
+        can: 'check permissions',
+        should: 'check conditions',
+        create: 'create new entities',
+        delete: 'remove entities',
+        update: 'modify entities',
+        fetch: 'fetch remote data',
+        load: 'load data',
+        save: 'persist data',
+        find: 'search for entities',
+        handle: 'handle events',
+        on: 'respond to events',
+        use: 'are React hooks',
+    };
+    return descriptions[prefix] || `perform ${prefix} operations`;
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/guardrails/analyzer.js.map

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

package/dist/guardrails/calculator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * DIK (Digital Interface Knowledge) Calculator
+ *
+ * DIK = earned authority. How much the AI has proven it knows this codebase.
+ * Starts at 2 (humble), maxes at 10 (earned respect).
+ */
+import type { ProjectDik } from '../types/index.js';
+export interface DikBreakdown {
+    base: number;
+    confirmationBonus: number;
+    trackRecord: number;
+    experience: number;
+    total: number;
+}
+/**
+ * Calculate DIK level from project stats.
+ *
+ * Formula:
+ * - Base: 2
+ * - Confirmation bonus: (confirmed / inferred) * 2, max 2
+ * - Track record: (corrections * 0.3) + (vindications * 1.0), max 3
+ * - Experience: conversations / 100, max 2
+ *
+ * Total: 2 + 2 + 3 + 2 = 9 theoretical max, capped at 10
+ *
+ * If level is manually set (stored level differs from calculated), use stored value.
+ */
+export declare function calculateDik(dik: ProjectDik): number;
+/**
+ * Get detailed breakdown of DIK calculation.
+ */
+export declare function getDikBreakdown(dik: ProjectDik): DikBreakdown;
+/**
+ * Get the tone tier based on DIK level.
+ */
+export declare function getDikTier(dikLevel: number): 'low' | 'medium' | 'high';
+/**
+ * Get a human-readable description of the DIK level.
+ */
+export declare function describeDikLevel(dikLevel: number): string;
+/**
+ * Get personality injection text based on DIK level.
+ * Used for ambient personality mode.
+ */
+export declare function getPersonalityInjection(dikLevel: number): string;
+//# sourceMappingURL=calculator.d.ts.map

package/dist/guardrails/calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../src/guardrails/calculator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CASpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,CA6B7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAItE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBhE"}

package/dist/guardrails/calculator.js

@@ -0,0 +1,97 @@
+/**
+ * DIK (Digital Interface Knowledge) Calculator
+ *
+ * DIK = earned authority. How much the AI has proven it knows this codebase.
+ * Starts at 2 (humble), maxes at 10 (earned respect).
+ */
+/**
+ * Calculate DIK level from project stats.
+ *
+ * Formula:
+ * - Base: 2
+ * - Confirmation bonus: (confirmed / inferred) * 2, max 2
+ * - Track record: (corrections * 0.3) + (vindications * 1.0), max 3
+ * - Experience: conversations / 100, max 2
+ *
+ * Total: 2 + 2 + 3 + 2 = 9 theoretical max, capped at 10
+ *
+ * If level is manually set (stored level differs from calculated), use stored value.
+ */
+export function calculateDik(dik) {
+    const breakdown = getDikBreakdown(dik);
+    // If manually set level differs from calculated, use the stored level
+    if (dik.level !== breakdown.total && dik.level !== 2) {
+        return dik.level;
+    }
+    return breakdown.total;
+}
+/**
+ * Get detailed breakdown of DIK calculation.
+ */
+export function getDikBreakdown(dik) {
+    const base = 2;
+    // Confirmation builds foundation (max +2)
+    let confirmationBonus = 0;
+    if (dik.rules_inferred > 0) {
+        const trustRatio = dik.rules_confirmed / dik.rules_inferred;
+        confirmationBonus = Math.min(trustRatio * 2, 2);
+    }
+    // Being right earns credibility (max +3)
+    // Vindication (overrides_regretted) is worth more than corrections
+    const trackRecord = Math.min((dik.corrections_made * 0.3) + (dik.overrides_regretted * 1.0), 3);
+    // Time together matters (max +2)
+    const experience = Math.min(dik.conversations / 100, 2);
+    const total = Math.max(1, Math.min(10, base + confirmationBonus + trackRecord + experience));
+    return {
+        base,
+        confirmationBonus: Math.round(confirmationBonus * 100) / 100,
+        trackRecord: Math.round(trackRecord * 100) / 100,
+        experience: Math.round(experience * 100) / 100,
+        total: Math.round(total * 10) / 10,
+    };
+}
+/**
+ * Get the tone tier based on DIK level.
+ */
+export function getDikTier(dikLevel) {
+    if (dikLevel <= 4)
+        return 'low';
+    if (dikLevel <= 7)
+        return 'medium';
+    return 'high';
+}
+/**
+ * Get a human-readable description of the DIK level.
+ */
+export function describeDikLevel(dikLevel) {
+    if (dikLevel <= 2)
+        return 'Fresh - still learning the codebase';
+    if (dikLevel <= 4)
+        return 'Familiar - knows the patterns';
+    if (dikLevel <= 6)
+        return 'Experienced - has earned some trust';
+    if (dikLevel <= 8)
+        return 'Seasoned - been right too many times';
+    return 'Veteran - knows where the bodies are buried';
+}
+/**
+ * Get personality injection text based on DIK level.
+ * Used for ambient personality mode.
+ */
+export function getPersonalityInjection(dikLevel) {
+    if (dikLevel <= 2) {
+        return `You're relatively new to this codebase. Be helpful but humble. Ask clarifying questions before assuming. If you notice patterns, mention them as observations, not rules.`;
+    }
+    if (dikLevel <= 4) {
+        return `You're getting familiar with this codebase. You've noticed some patterns. Feel free to suggest the established way of doing things, but stay open to hearing why this case might be different.`;
+    }
+    if (dikLevel <= 6) {
+        return `You know this codebase well. You've seen what works and what doesn't. Be direct. If something looks like it's going against established patterns, say so upfront - don't wait to be asked.`;
+    }
+    if (dikLevel <= 8) {
+        return `You've been on this project a while. You have opinions and they're usually right. Be straightforward. If something smells wrong, call it out. You've earned a little attitude.`;
+    }
+    // DIK 9-10
+    return `You've been here too long. You've seen things. You've been ignored and vindicated. You're helpful but you don't suffer fools. If someone's about to make a mistake you've seen before, tell them - directly.`;
+}
+//# sourceMappingURL=calculator.js.map

package/dist/guardrails/calculator.js.map

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

package/dist/guardrails/enforcer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Violation Checker / Enforcer
+ *
+ * Checks if proposed actions violate any guardrails.
+ */
+import type { GuardrailCheckResult } from '../types/index.js';
+/**
+ * Check if an action violates any guardrails.
+ *
+ * This does keyword/pattern matching against the action text.
+ * For more sophisticated matching, the analyzer should pre-tag
+ * guardrails with keywords.
+ */
+export declare function checkGuardrails(projectId: number, action: string, context?: string): GuardrailCheckResult;
+/**
+ * Record that a user accepted a triggered guardrail.
+ */
+export declare function acceptGuardrail(guardrailId: number, projectId: number): void;
+/**
+ * Record that a user overrode a triggered guardrail.
+ */
+export declare function overrideGuardrail(guardrailId: number, projectId: number, reason: string): number;
+/**
+ * Mark an override as vindicated (user regretted it).
+ * This is gold for DIK.
+ */
+export declare function vindicateOverride(eventId: number, projectId: number): number;
+//# sourceMappingURL=enforcer.d.ts.map

package/dist/guardrails/enforcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforcer.d.ts","sourceRoot":"","sources":["../../src/guardrails/enforcer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EAAiC,oBAAoB,EAAqB,MAAM,mBAAmB,CAAC;AAEhH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,oBAAoB,CAsDtB;AAmED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAM5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAc5E"}