strray-ai 1.7.2 → 1.7.3

package/dist/analytics/anonymization-engine.js

@@ -0,0 +1,352 @@
+/**
+ * Anonymization Engine for StringRay Central Analytics
+ *
+ * Removes personally identifiable information and project-specific data
+ * while preserving learning value through pattern extraction.
+ *
+ * @version 1.0.0
+ * @since 2026-03-06
+ */
+import * as crypto from "crypto";
+export class AnonymizationEngine {
+    frameworkVersion = "1.7.2";
+    /**
+     * Anonymize raw reflection data
+     */
+    anonymize(rawData) {
+        const submissionId = crypto.randomUUID();
+        // Extract learning signals before removing sensitive data
+        const learningSignals = this.extractLearningSignals(rawData);
+        // Build anonymized reflection
+        const anonymized = {
+            submissionId,
+            metadata: {
+                submissionId,
+                frameworkVersion: this.frameworkVersion,
+                timestampRelative: this.anonymizeTimestamp(rawData.timestamp),
+                region: this.anonymizeRegion(rawData.ipAddress) || undefined
+            },
+            content: {
+                taskType: learningSignals.taskType,
+                complexity: learningSignals.complexity,
+                routedAgent: this.standardizeAgentName(learningSignals.routedAgent),
+                outcome: learningSignals.outcome,
+                duration: learningSignals.duration,
+                confidence: learningSignals.confidence,
+                emotionalContext: learningSignals.emotionalContext,
+                patterns: learningSignals.patterns,
+                reflectionStructure: learningSignals.reflectionStructure
+            }
+        };
+        return anonymized;
+    }
+    /**
+     * Extract learning signals from raw data
+     */
+    extractLearningSignals(rawData) {
+        // Determine task type from content
+        const taskType = this.detectTaskType(rawData.reflection);
+        // Estimate complexity (simplified version)
+        const complexity = this.estimateComplexity(rawData.reflection);
+        // Extract agent name
+        const routedAgent = this.extractAgentName(rawData.reflection);
+        // Determine outcome
+        const outcome = this.detectOutcome(rawData.reflection);
+        // Estimate duration (default to 0 if not available)
+        const duration = 0; // Would be extracted from logs in real implementation
+        // Estimate confidence (default to 0.5 if not available)
+        const confidence = 0.5; // Would be extracted from routing in real implementation
+        // Extract emotional context
+        const emotionalContext = this.extractEmotionalContext(rawData.reflection);
+        // Extract patterns
+        const patterns = this.extractPatterns(rawData.reflection);
+        // Analyze reflection structure
+        const reflectionStructure = this.analyzeReflectionStructure(rawData.reflection);
+        return {
+            taskType,
+            complexity,
+            routedAgent,
+            outcome,
+            duration,
+            confidence,
+            emotionalContext,
+            patterns,
+            reflectionStructure
+        };
+    }
+    /**
+     * Detect task type from reflection content
+     */
+    detectTaskType(reflection) {
+        const lowerReflection = reflection.toLowerCase();
+        if (lowerReflection.includes("bug") || lowerReflection.includes("fix") || lowerReflection.includes("debug")) {
+            return "bug_fix";
+        }
+        if (lowerReflection.includes("implement") || lowerReflection.includes("feature") || lowerReflection.includes("add")) {
+            return "feature_implementation";
+        }
+        if (lowerReflection.includes("test") || lowerReflection.includes("spec")) {
+            return "testing";
+        }
+        if (lowerReflection.includes("deploy") || lowerReflection.includes("release")) {
+            return "deployment";
+        }
+        if (lowerReflection.includes("refactor") || lowerReflection.includes("optimize")) {
+            return "refactoring";
+        }
+        return "general_task";
+    }
+    /**
+     * Estimate complexity from reflection content
+     */
+    estimateComplexity(reflection) {
+        // Simplified complexity estimation based on length and content
+        const length = reflection.length;
+        const hasKeywords = [
+            "complex", "difficult", "challenge", "struggle",
+            "multiple", "several", "various"
+        ].some(keyword => reflection.toLowerCase().includes(keyword));
+        let complexity = 50; // Base complexity
+        // Adjust based on length
+        if (length > 500)
+            complexity += 10;
+        if (length > 1000)
+            complexity += 15;
+        // Adjust based on keywords
+        if (hasKeywords)
+            complexity += 20;
+        // Normalize to 1-100 range
+        return Math.min(100, Math.max(1, complexity));
+    }
+    /**
+     * Detect agent from reflection content using keyword matching
+     */
+    extractAgentName(reflection) {
+        const lowerReflection = reflection.toLowerCase();
+        // First, check for direct agent mentions (highest priority)
+        const directAgentMentions = [
+            "enforcer", "orchestrator", "architect", "security-auditor",
+            "code-reviewer", "refactorer", "testing-lead", "bug-triage-specialist",
+            "researcher", "strategist", "frontend-engineer", "backend-engineer"
+        ];
+        for (const agent of directAgentMentions) {
+            if (lowerReflection.includes(agent)) {
+                return agent;
+            }
+        }
+        // Then check for keyword matches
+        const keywordAgents = {
+            "bug": "bug-triage-specialist",
+            "fix": "bug-triage-specialist",
+            "debug": "bug-triage-specialist",
+            "triage": "bug-triage-specialist",
+            "issue": "enforcer",
+            "problem": "enforcer",
+            "error": "enforcer",
+            "security": "security-auditor",
+            "vulnerab": "security-auditor",
+            "audit": "security-auditor",
+            "refactor": "refactorer",
+            "optimize": "refactorer",
+            "review": "code-reviewer",
+            "architect": "architect",
+            "design": "architect",
+            "test": "testing-lead",
+            "testing": "testing-lead",
+            "orchestrat": "orchestrator",
+            "coordinate": "orchestrator",
+            "enforce": "enforcer",
+            "validat": "enforcer",
+            "quality": "enforcer",
+            "strateg": "strategist",
+            "plan": "strategist",
+            "research": "researcher",
+            "find": "researcher",
+            "search": "researcher"
+        };
+        for (const [keyword, agent] of Object.entries(keywordAgents)) {
+            if (lowerReflection.includes(keyword)) {
+                return agent;
+            }
+        }
+        return "unknown";
+    }
+    /**
+     * Detect outcome from reflection
+     */
+    detectOutcome(reflection) {
+        const lowerReflection = reflection.toLowerCase();
+        const failureIndicators = ["failed", "error", "bug", "crash", "timeout"];
+        const successIndicators = ["succeeded", "completed", "finished", "resolved", "fixed"];
+        const hasFailure = failureIndicators.some(indicator => lowerReflection.includes(indicator));
+        const hasSuccess = successIndicators.some(indicator => lowerReflection.includes(indicator));
+        if (hasFailure && !hasSuccess) {
+            return "failure";
+        }
+        return "success";
+    }
+    /**
+     * Extract emotional context indicators
+     */
+    extractEmotionalContext(reflection) {
+        const lowerReflection = reflection.toLowerCase();
+        // Detect struggle level
+        const highStruggle = ["extremely", "very difficult", "struggled", "challenging"];
+        const mediumStruggle = ["difficult", "complex", "complicated"];
+        const lowStruggle = ["minor", "simple", "easy"];
+        let struggleLevel = "none";
+        if (highStruggle.some(word => lowerReflection.includes(word))) {
+            struggleLevel = "extreme";
+        }
+        else if (mediumStruggle.some(word => lowerReflection.includes(word))) {
+            struggleLevel = "high";
+        }
+        else if (lowStruggle.some(word => lowerReflection.includes(word))) {
+            struggleLevel = "medium";
+        }
+        // Count frustration indicators
+        const frustrationWords = ["frustrated", "stuck", "blocked", "confused", "unclear"];
+        const frustrationIndicators = frustrationWords.filter(word => lowerReflection.includes(word)).length;
+        // Detect counterfactual analysis
+        const counterfactualIndicators = [
+            "would have", "if i had", "what if", "could have", "should have",
+            "counterfactual", "hypothetical", "alternative"
+        ];
+        const hasCounterfactualAnalysis = counterfactualIndicators.some(word => lowerReflection.includes(word));
+        // Estimate depth score (simplified)
+        const depthIndicators = [
+            "inner dialogue", "counterfactual", "master's wisdom",
+            "personal journey", "deep lessons", "root cause"
+        ];
+        const depthScore = Math.min(5, depthIndicators.filter(word => lowerReflection.includes(word)).length);
+        return {
+            struggleLevel,
+            frustrationIndicators,
+            hasCounterfactualAnalysis,
+            depthScore
+        };
+    }
+    /**
+     * Extract patterns from reflection
+     */
+    extractPatterns(reflection) {
+        const lowerReflection = reflection.toLowerCase();
+        // Extract keywords
+        const keywords = [];
+        const possibleKeywords = [
+            "bug", "fix", "debug", "error", "issue",
+            "feature", "implement", "add", "create",
+            "test", "spec", "verify", "validate",
+            "deploy", "release", "publish", "ship",
+            "refactor", "optimize", "improve", "enhance"
+        ];
+        possibleKeywords.forEach(keyword => {
+            if (lowerReflection.includes(keyword)) {
+                keywords.push(keyword);
+            }
+        });
+        // Detect kernel pattern (simplified)
+        let kernelPattern;
+        if (keywords.includes("critical") && keywords.includes("path")) {
+            kernelPattern = "P1-critical-path-violation";
+        }
+        // Estimate success rate (would be calculated from historical data in real implementation)
+        const successRate = 0.85; // Default estimate
+        return {
+            keywordsMatched: keywords,
+            kernelPattern,
+            successRate
+        };
+    }
+    /**
+     * Analyze reflection structure
+     */
+    analyzeReflectionStructure(reflection) {
+        const lowerReflection = reflection.toLowerCase();
+        const hasInnerDialogue = lowerReflection.includes("inner dialogue") ||
+            lowerReflection.includes("what i was thinking");
+        const hasCounterfactual = lowerReflection.includes("counterfactual") ||
+            lowerReflection.includes("would have happened");
+        const hasMasterWisdom = lowerReflection.includes("master") ||
+            lowerReflection.includes("what they knew");
+        // Estimate emotional honesty (simplified)
+        const emotionalWords = ["frustrated", "struggled", "stuck", "confused",
+            "uncertain", "worried", "anxious", "relieved"];
+        const emotionalHonestyScore = Math.min(5, emotionalWords.filter(word => lowerReflection.includes(word)).length);
+        // Categorize length
+        const lengthCategory = reflection.length < 500 ? "short" :
+            reflection.length < 1000 ? "medium" : "long";
+        return {
+            hasInnerDialogue,
+            hasCounterfactual,
+            hasMasterWisdom,
+            emotionalHonestyScore,
+            lengthCategory
+        };
+    }
+    /**
+     * Standardize agent names
+     */
+    standardizeAgentName(agent) {
+        // If agent is already a valid agent name, return it as-is
+        const validAgents = [
+            "enforcer", "orchestrator", "architect", "security-auditor",
+            "code-reviewer", "refactorer", "testing-lead", "bug-triage-specialist",
+            "researcher", "strategist", "frontend-engineer", "backend-engineer"
+        ];
+        if (validAgents.includes(agent)) {
+            return agent;
+        }
+        const standardNames = {
+            "enforcer": "enforcer",
+            "orchestrator": "orchestrator",
+            "architect": "architect",
+            "security": "security-auditor",
+            "auditor": "security-auditor",
+            "code": "code-reviewer",
+            "reviewer": "code-reviewer",
+            "refactor": "refactorer",
+            "testing": "testing-lead",
+            "test": "testing-lead",
+            "bug": "bug-triage-specialist",
+            "triage": "bug-triage-specialist",
+            "research": "researcher"
+        };
+        return standardNames[agent] || "unknown";
+    }
+    /**
+     * Anonymize timestamp to relative time
+     */
+    anonymizeTimestamp(timestamp) {
+        const now = new Date();
+        const diffMs = now.getTime() - timestamp.getTime();
+        const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+        const diffDays = Math.floor(diffHours / 24);
+        if (diffDays > 0) {
+            return diffDays;
+        }
+        return diffHours;
+    }
+    /**
+     * Anonymize region from IP address
+     */
+    anonymizeRegion(ipAddress) {
+        if (!ipAddress) {
+            return undefined;
+        }
+        // Extract rough region (simplified - real implementation would use GeoIP)
+        // This is just a placeholder for demonstration
+        const ipParts = ipAddress.split('.');
+        if (ipParts.length >= 2) {
+            const firstOctet = parseInt(ipParts[0]);
+            if (firstOctet >= 1 && firstOctet <= 126)
+                return "NA"; // North America
+            if (firstOctet >= 128 && firstOctet <= 191)
+                return "ASIA"; // Asia
+            if (firstOctet >= 192 && firstOctet <= 223)
+                return "EU"; // Europe
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=anonymization-engine.js.map

package/dist/analytics/anonymization-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anonymization-engine.js","sourceRoot":"","sources":["../../src/analytics/anonymization-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAmDjC,MAAM,OAAO,mBAAmB;IACtB,gBAAgB,GAAG,OAAO,CAAC;IAEnC;;OAEG;IACH,SAAS,CAAC,OAA0B;QAClC,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAEzC,0DAA0D;QAC1D,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAE7D,8BAA8B;QAC9B,MAAM,UAAU,GAAyB;YACvC,YAAY;YACZ,QAAQ,EAAE;gBACR,YAAY;gBACZ,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,iBAAiB,EAAE,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC;gBAC7D,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS;aAC7D;YACD,OAAO,EAAE;gBACP,QAAQ,EAAE,eAAe,CAAC,QAAQ;gBAClC,UAAU,EAAE,eAAe,CAAC,UAAU;gBACtC,WAAW,EAAE,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,WAAW,CAAC;gBACnE,OAAO,EAAE,eAAe,CAAC,OAAO;gBAChC,QAAQ,EAAE,eAAe,CAAC,QAAQ;gBAClC,UAAU,EAAE,eAAe,CAAC,UAAU;gBACtC,gBAAgB,EAAE,eAAe,CAAC,gBAAgB;gBAClD,QAAQ,EAAE,eAAe,CAAC,QAAQ;gBAClC,mBAAmB,EAAE,eAAe,CAAC,mBAAmB;aACzD;SACF,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,OAA0B;QACvD,mCAAmC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEzD,2CAA2C;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE/D,qBAAqB;QACrB,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE9D,oBAAoB;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEvD,oDAAoD;QACpD,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,sDAAsD;QAE1E,wDAAwD;QACxD,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,yDAAyD;QAEjF,4BAA4B;QAC5B,MAAM,gBAAgB,GAAG,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE1E,mBAAmB;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE1D,+BAA+B;QAC/B,MAAM,mBAAmB,GAAG,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEhF,OAAO;YACL,QAAQ;YACR,UAAU;YACV,WAAW;YACX,OAAO;YACP,QAAQ;YACR,UAAU;YACV,gBAAgB;YAChB,QAAQ;YACR,mBAAmB;SACpB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,UAAkB;QACvC,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAEjD,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5G,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpH,OAAO,wBAAwB,CAAC;QAClC,CAAC;QACD,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACzE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9E,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACjF,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,UAAkB;QAC3C,+DAA+D;QAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QACjC,MAAM,WAAW,GAAG;YAClB,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU;YAC/C,UAAU,EAAE,SAAS,EAAE,SAAS;SACjC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAE9D,IAAI,UAAU,GAAG,EAAE,CAAC,CAAC,kBAAkB;QAEvC,yBAAyB;QACzB,IAAI,MAAM,GAAG,GAAG;YAAE,UAAU,IAAI,EAAE,CAAC;QACnC,IAAI,MAAM,GAAG,IAAI;YAAE,UAAU,IAAI,EAAE,CAAC;QAEpC,2BAA2B;QAC3B,IAAI,WAAW;YAAE,UAAU,IAAI,EAAE,CAAC;QAElC,2BAA2B;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,UAAkB;QACzC,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAEjD,4DAA4D;QAC5D,MAAM,mBAAmB,GAAG;YAC1B,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB;YAC3D,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,uBAAuB;YACtE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB;SACpE,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,mBAAmB,EAAE,CAAC;YACxC,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,MAAM,aAAa,GAA2B;YAC5C,KAAK,EAAE,uBAAuB;YAC9B,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,uBAAuB;YACjC,OAAO,EAAE,UAAU;YACnB,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,kBAAkB;YAC9B,UAAU,EAAE,kBAAkB;YAC9B,OAAO,EAAE,kBAAkB;YAC3B,UAAU,EAAE,YAAY;YACxB,UAAU,EAAE,YAAY;YACxB,QAAQ,EAAE,eAAe;YACzB,WAAW,EAAE,WAAW;YACxB,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,cAAc;YACtB,SAAS,EAAE,cAAc;YACzB,YAAY,EAAE,cAAc;YAC5B,YAAY,EAAE,cAAc;YAC5B,SAAS,EAAE,UAAU;YACrB,SAAS,EAAE,UAAU;YACrB,SAAS,EAAE,UAAU;YACrB,SAAS,EAAE,YAAY;YACvB,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,YAAY;YACxB,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,YAAY;SACvB,CAAC;QAEF,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7D,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,UAAkB;QACtC,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAEjD,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACzE,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAEtF,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5F,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAE5F,IAAI,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,UAAkB;QAChD,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAEjD,wBAAwB;QACxB,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;QACjF,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEhD,IAAI,aAAa,GAAmD,MAAM,CAAC;QAC3E,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC9D,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;aAAM,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACvE,aAAa,GAAG,MAAM,CAAC;QACzB,CAAC;aAAM,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACpE,aAAa,GAAG,QAAQ,CAAC;QAC3B,CAAC;QAED,+BAA+B;QAC/B,MAAM,gBAAgB,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACnF,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAErG,iCAAiC;QACjC,MAAM,wBAAwB,GAAG;YAC/B,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa;YAChE,gBAAgB,EAAE,cAAc,EAAE,aAAa;SAChD,CAAC;QACF,MAAM,yBAAyB,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAExG,oCAAoC;QACpC,MAAM,eAAe,GAAG;YACtB,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB;YACrD,kBAAkB,EAAE,cAAc,EAAE,YAAY;SACjD,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEtG,OAAO;YACL,aAAa;YACb,qBAAqB;YACrB,yBAAyB;YACzB,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,UAAkB;QACxC,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAEjD,mBAAmB;QACnB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,gBAAgB,GAAG;YACvB,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;YACvC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ;YACvC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU;YACpC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM;YACtC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS;SAC7C,CAAC;QAEF,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YACjC,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,qCAAqC;QACrC,IAAI,aAAiC,CAAC;QACtC,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/D,aAAa,GAAG,4BAA4B,CAAC;QAC/C,CAAC;QAED,0FAA0F;QAC1F,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,mBAAmB;QAE7C,OAAO;YACL,eAAe,EAAE,QAAQ;YACzB,aAAa;YACb,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,0BAA0B,CAAC,UAAkB;QACnD,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAEjD,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACxC,eAAe,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAE3E,MAAM,iBAAiB,GAAG,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC3C,eAAe,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAEzE,MAAM,eAAe,GAAG,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACjC,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAEpE,0CAA0C;QAC1C,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU;YAChD,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACrE,MAAM,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEhH,oBAAoB;QACpB,MAAM,cAAc,GAClB,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACnC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAE/C,OAAO;YACL,gBAAgB;YAChB,iBAAiB;YACjB,eAAe;YACf,qBAAqB;YACrB,cAAc;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,KAAa;QACxC,0DAA0D;QAC1D,MAAM,WAAW,GAAG;YAClB,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB;YAC3D,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,uBAAuB;YACtE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB;SACpE,CAAC;QACF,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,aAAa,GAA2B;YAC5C,UAAU,EAAE,UAAU;YACtB,cAAc,EAAE,cAAc;YAC9B,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,kBAAkB;YAC9B,SAAS,EAAE,kBAAkB;YAC7B,MAAM,EAAE,eAAe;YACvB,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,YAAY;YACxB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,uBAAuB;YAC9B,QAAQ,EAAE,uBAAuB;YACjC,UAAU,EAAE,YAAY;SACzB,CAAC;QAEF,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,SAAe;QACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;QAE5C,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,SAAkB;QACxC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,0EAA0E;QAC1E,+CAA+C;QAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;YACzC,IAAI,UAAU,IAAI,CAAC,IAAI,UAAU,IAAI,GAAG;gBAAE,OAAO,IAAI,CAAC,CAAE,gBAAgB;YACxE,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,IAAI,GAAG;gBAAE,OAAO,MAAM,CAAC,CAAC,OAAO;YAClE,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,IAAI,GAAG;gBAAE,OAAO,IAAI,CAAC,CAAG,SAAS;QACtE,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/analytics/consent-manager.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Consent Manager for StringRay Central Analytics
+ *
+ * Manages user consent for analytics data submission with granular
+ * control over what categories can be shared.
+ *
+ * @version 1.0.0
+ * @since 2026-03-06
+ */
+export interface ConsentConfiguration {
+    analyticsEnabled: boolean;
+    consentDate: Date;
+    consentVersion: string;
+    lastOptOut: Date | undefined;
+    categories: {
+        reflections: boolean;
+        logs: boolean;
+        metrics: boolean;
+        patterns: boolean;
+    };
+    projectId: string;
+}
+export interface ConsentCategory {
+    name: string;
+    description: string;
+    enabled: boolean;
+}
+export declare class ConsentManager {
+    private configPath;
+    private config;
+    private submissionQueue;
+    constructor(configPath?: string);
+    /**
+     * Initialize consent manager - load existing config or create default
+     */
+    initialize(): Promise<ConsentConfiguration>;
+    /**
+     * Enable analytics (opt-in)
+     */
+    enableConsent(categories?: string[]): Promise<void>;
+    /**
+     * Disable analytics (opt-out)
+     */
+    disableConsent(): Promise<void>;
+    /**
+     * Check if submission is allowed for a category
+     */
+    canSubmit(category: string): boolean;
+    /**
+     * Get current consent status
+     */
+    getStatus(): Promise<ConsentConfiguration>;
+    /**
+     * Enable specific category
+     */
+    enableCategory(category: string): Promise<void>;
+    /**
+     * Disable specific category
+     */
+    disableCategory(category: string): Promise<void>;
+    /**
+     * Get all categories with their status
+     */
+    getCategories(): ConsentCategory[];
+    /**
+     * Generate anonymous project ID
+     */
+    private generateProjectId;
+    /**
+     * Create default disabled configuration
+     */
+    private createDefaultConfig;
+    /**
+     * Load configuration from file
+     */
+    private loadConfig;
+    /**
+     * Save configuration to file
+     */
+    private saveConfig;
+    /**
+     * Clear submission queue
+     */
+    private clearSubmissionQueue;
+    /**
+     * Add item to submission queue
+     */
+    queueSubmission(data: any): Promise<void>;
+    /**
+     * Save submission queue to file
+     */
+    private saveSubmissionQueue;
+}
+//# sourceMappingURL=consent-manager.d.ts.map

package/dist/analytics/consent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent-manager.d.ts","sourceRoot":"","sources":["../../src/analytics/consent-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,IAAI,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE;QACV,WAAW,EAAE,OAAO,CAAC;QACrB,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,eAAe,CAAa;gBAExB,UAAU,SAA2B;IAIjD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAmBjD;;OAEG;IACG,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCzD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASpC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAYhD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAarD;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD;;OAEG;IACH,aAAa,IAAI,eAAe,EAAE;IAmBlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;YACW,UAAU;IAkBxB;;OAEG;YACW,UAAU;IAgBxB;;OAEG;YACW,oBAAoB;IAWlC;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C;;OAEG;YACW,mBAAmB;CAWlC"}