@rangerchaz/aimem 0.1.5 → 0.2.0

package/dist/guardrails/enforcer.js

@@ -0,0 +1,153 @@
+/**
+ * Violation Checker / Enforcer
+ *
+ * Checks if proposed actions violate any guardrails.
+ */
+import { getProjectGuardrails, getOrCreateProjectDik, getGuardrailHistory, insertGuardrailEvent, incrementDikCounter, getGuardrailEvent, } from '../db/index.js';
+import { calculateDik } from './calculator.js';
+import { generateCombinedResponse } from './responder.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 function checkGuardrails(projectId, action, context) {
+    const guardrails = getProjectGuardrails(projectId, { activeOnly: true });
+    const dikData = getOrCreateProjectDik(projectId);
+    const dikLevel = calculateDik(dikData);
+    const violations = [];
+    const violationHistories = [];
+    const actionLower = action.toLowerCase();
+    const contextLower = context?.toLowerCase() || '';
+    const combined = actionLower + ' ' + contextLower;
+    for (const guardrail of guardrails) {
+        if (matchesGuardrail(combined, guardrail)) {
+            const violation = {
+                id: guardrail.id,
+                rule: guardrail.rule,
+                category: guardrail.category,
+                severity: guardrail.severity,
+                rationale: guardrail.rationale,
+            };
+            violations.push(violation);
+            const history = getGuardrailHistory(guardrail.id);
+            violationHistories.push({
+                violation,
+                history: {
+                    previousOverrides: history.overrides,
+                    wasVindicated: history.vindicated,
+                },
+            });
+            // Log the trigger event
+            insertGuardrailEvent(guardrail.id, 'triggered', action.slice(0, 500), // Truncate for storage
+            null, dikLevel);
+        }
+    }
+    // Increment conversation count
+    incrementDikCounter(projectId, 'conversations');
+    // Generate response
+    const response = generateCombinedResponse(violationHistories, dikLevel);
+    return {
+        violations,
+        dik_level: dikLevel,
+        response,
+    };
+}
+/**
+ * Check if the action text matches a guardrail.
+ *
+ * This uses simple keyword matching. Rules can contain:
+ * - Exact phrases to look for
+ * - Category-specific patterns
+ */
+function matchesGuardrail(text, guardrail) {
+    // Extract keywords from the rule
+    const keywords = extractKeywords(guardrail.rule, guardrail.category);
+    // Check if any keyword matches
+    for (const keyword of keywords) {
+        if (text.includes(keyword.toLowerCase())) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Extract keywords from a rule for matching.
+ */
+function extractKeywords(rule, category) {
+    const keywords = [];
+    // Extract quoted phrases
+    const quotedMatches = rule.match(/"[^"]+"/g) || [];
+    for (const match of quotedMatches) {
+        keywords.push(match.slice(1, -1)); // Remove quotes
+    }
+    // Extract backtick-wrapped code
+    const codeMatches = rule.match(/`[^`]+`/g) || [];
+    for (const match of codeMatches) {
+        keywords.push(match.slice(1, -1)); // Remove backticks
+    }
+    // Category-specific keyword extraction
+    switch (category) {
+        case 'naming':
+            // Look for case patterns mentioned
+            if (rule.includes('snake_case'))
+                keywords.push('snake_case');
+            if (rule.includes('camelCase'))
+                keywords.push('camelCase');
+            if (rule.includes('PascalCase'))
+                keywords.push('PascalCase');
+            if (rule.includes('kebab-case'))
+                keywords.push('kebab-case');
+            break;
+        case 'architecture':
+            // Look for path patterns
+            const pathMatches = rule.match(/\/[a-zA-Z_-]+\//g) || [];
+            keywords.push(...pathMatches);
+            break;
+        case 'security':
+            // Common security keywords
+            if (rule.toLowerCase().includes('auth'))
+                keywords.push('password', 'token', 'secret', 'credential');
+            if (rule.toLowerCase().includes('sanitiz'))
+                keywords.push('sanitize', 'escape', 'validate');
+            break;
+    }
+    return keywords;
+}
+/**
+ * Record that a user accepted a triggered guardrail.
+ */
+export function acceptGuardrail(guardrailId, projectId) {
+    const dikData = getOrCreateProjectDik(projectId);
+    const dikLevel = calculateDik(dikData);
+    insertGuardrailEvent(guardrailId, 'accepted', null, null, dikLevel);
+    incrementDikCounter(projectId, 'corrections_made');
+}
+/**
+ * Record that a user overrode a triggered guardrail.
+ */
+export function overrideGuardrail(guardrailId, projectId, reason) {
+    const dikData = getOrCreateProjectDik(projectId);
+    const dikLevel = calculateDik(dikData);
+    const event = insertGuardrailEvent(guardrailId, 'overridden', reason, null, dikLevel);
+    return event.id;
+}
+/**
+ * Mark an override as vindicated (user regretted it).
+ * This is gold for DIK.
+ */
+export function vindicateOverride(eventId, projectId) {
+    const dikData = getOrCreateProjectDik(projectId);
+    // Get the event to find the guardrail
+    const event = getGuardrailEvent(eventId);
+    if (event && event.event_type === 'overridden') {
+        insertGuardrailEvent(event.guardrail_id, 'vindicated', null, null, calculateDik(dikData));
+        incrementDikCounter(projectId, 'overrides_regretted');
+    }
+    // Recalculate and return new DIK level
+    const updatedDik = getOrCreateProjectDik(projectId);
+    return calculateDik(updatedDik);
+}
+//# sourceMappingURL=enforcer.js.map

package/dist/guardrails/enforcer.js.map

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

package/dist/guardrails/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Guardrails Module - DIK (Digital Interface Knowledge)
+ *
+ * A rules enforcement system that earns authority over time.
+ * The AI doesn't just remember - it has opinions, and those opinions are earned.
+ */
+export { calculateDik, getDikBreakdown, getDikTier, describeDikLevel, getPersonalityInjection, type DikBreakdown, } from './calculator.js';
+export { analyzeProject, saveProposedRules, } from './analyzer.js';
+export { checkGuardrails, acceptGuardrail, overrideGuardrail, vindicateOverride, } from './enforcer.js';
+export { generateResponse, generateCombinedResponse, formatSeverityPrefix, } from './responder.js';
+export { importLinterRules, type LinterConfig, type ImportedRule, } from './linter-import.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guardrails/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/guardrails/index.js

@@ -0,0 +1,17 @@
+/**
+ * Guardrails Module - DIK (Digital Interface Knowledge)
+ *
+ * A rules enforcement system that earns authority over time.
+ * The AI doesn't just remember - it has opinions, and those opinions are earned.
+ */
+// Calculator exports
+export { calculateDik, getDikBreakdown, getDikTier, describeDikLevel, getPersonalityInjection, } from './calculator.js';
+// Analyzer exports
+export { analyzeProject, saveProposedRules, } from './analyzer.js';
+// Enforcer exports
+export { checkGuardrails, acceptGuardrail, overrideGuardrail, vindicateOverride, } from './enforcer.js';
+// Responder exports
+export { generateResponse, generateCombinedResponse, formatSeverityPrefix, } from './responder.js';
+// Linter import exports
+export { importLinterRules, } from './linter-import.js';
+//# sourceMappingURL=index.js.map

package/dist/guardrails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guardrails/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAqB;AACrB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,uBAAuB,GAExB,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,wBAAwB;AACxB,OAAO,EACL,iBAAiB,GAGlB,MAAM,oBAAoB,CAAC"}

package/dist/guardrails/linter-import.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Linter Import
+ *
+ * Imports rules from existing linter configurations and converts them to guardrails.
+ * Supports: ESLint, RuboCop, Ruff/Black/isort (pyproject.toml), Prettier
+ */
+import type { Guardrail, GuardrailCategory } from '../types/index.js';
+export interface LinterConfig {
+    type: string;
+    path: string;
+    rules: ImportedRule[];
+}
+export interface ImportedRule {
+    category: GuardrailCategory;
+    rule: string;
+    rationale: string;
+    source: string;
+}
+interface ImportResult {
+    configs: LinterConfig[];
+    totalRules: number;
+    saved: Guardrail[];
+}
+/**
+ * Scan project for linter configs and import rules.
+ */
+export declare function importLinterRules(projectId: number, projectPath: string, options?: {
+    dryRun?: boolean;
+}): ImportResult;
+export {};
+//# sourceMappingURL=linter-import.d.ts.map

package/dist/guardrails/linter-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter-import.d.ts","sourceRoot":"","sources":["../../src/guardrails/linter-import.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,YAAY,CA6Cd"}