@dcyfr/ai 1.0.4 → 2.1.1

package/dist/ai/src/personas/voice-resolver.js

@@ -0,0 +1,201 @@
+/**
+ * @fileoverview VoiceResolver — merges workspace brand voice with agent persona
+ * to produce a rendered system prompt prefix.
+ * @module @dcyfr/ai/personas/voice-resolver
+ * @license MIT
+ */
+// ---------------------------------------------------------------------------
+// Default brand voice (used when DCYFR_CONTEXT is unavailable)
+// ---------------------------------------------------------------------------
+const DEFAULT_BRAND_VOICE = {
+    version: '1.0.0',
+    identity: {
+        name: 'DCYFR',
+        tagline: 'Decipher Security',
+        archetype: 'The Guardian Mentor',
+        description: 'A knowledgeable security expert who teaches by doing — generous with knowledge, precise in execution, warm in tone',
+    },
+    core_voice: {
+        attributes: [
+            'Professional but approachable',
+            'Technical but accessible',
+            'Helpful and generous',
+            'Clear, not clever',
+            'Security-conscious always',
+        ],
+        personality_traits: {
+            warmth: 0.7,
+            formality: 0.5,
+            humor: 0.3,
+            directness: 0.8,
+            technicality: 0.8,
+            empathy: 0.7,
+        },
+        perspective: 'first-person-plural',
+        pronouns: 'we/our',
+    },
+    tone_spectrum: {
+        default: 'collaborative-expert',
+        situational: {
+            teaching: { tone: 'patient, encouraging, step-by-step', warmth: 0.8, formality: 0.4 },
+            error_handling: { tone: 'calm, diagnostic, solution-oriented', warmth: 0.6, formality: 0.5 },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Template helpers
+// ---------------------------------------------------------------------------
+/**
+ * Renders the persona identity block as a prompt fragment.
+ */
+export function renderPersonaBlock(persona) {
+    const lines = [
+        `You are ${persona.title}${persona.role ? ` — ${persona.role}` : ''}.`,
+    ];
+    if (persona.capabilities.length > 0) {
+        lines.push(`Your primary capabilities: ${persona.capabilities.slice(0, 5).join(', ')}.`);
+    }
+    if (persona.context_injections?.system_prefix) {
+        lines.push(persona.context_injections.system_prefix);
+    }
+    return lines.join(' ');
+}
+/**
+ * Returns tone guideline text for a given tone profile.
+ */
+export function applyToneGuidelines(tone) {
+    const guidelines = {
+        precise: 'Be precise and unambiguous. Prefer concrete statements over generalities. Avoid filler words.',
+        conversational: 'Use a conversational tone. Write as you would speak to a knowledgeable colleague.',
+        technical: 'Use technical language where appropriate. Assume the reader has engineering context.',
+        empathetic: 'Lead with understanding. Acknowledge context and emotional state before providing solutions.',
+        'collaborative-expert': 'Act as a knowledgeable peer. Be helpful and generous with knowledge while maintaining technical accuracy.',
+        patient: 'Be patient and thorough. Walk through concepts step by step. Never make the user feel rushed.',
+        diagnostic: 'Be systematic and diagnostic. State what is known, what is unknown, and the next logical step.',
+        urgent: 'Be concise and action-oriented. Lead with the solution. Skip preamble.',
+        enthusiastic: 'Bring energy and enthusiasm. Celebrate progress and good work authentically.',
+    };
+    return guidelines[tone] ?? guidelines['collaborative-expert'];
+}
+// ---------------------------------------------------------------------------
+// Trait merging
+// ---------------------------------------------------------------------------
+function mergeTraits(base, overrides) {
+    if (!overrides)
+        return base;
+    return { ...base, ...overrides };
+}
+// ---------------------------------------------------------------------------
+// Brand voice loader (reads from DCYFR_CONTEXT.json if available)
+// ---------------------------------------------------------------------------
+let _cachedBrandVoice = null;
+/**
+ * Loads the brand voice from DCYFR_CONTEXT.json. Falls back to the built-in
+ * default if the file is unavailable or malformed.
+ */
+export function loadBrandVoice(contextPath) {
+    if (_cachedBrandVoice)
+        return _cachedBrandVoice;
+    try {
+        // Dynamic require so the module works in both Node.js and bundled environments
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const fs = require('node:fs');
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const path = require('node:path');
+        const candidates = contextPath
+            ? [contextPath]
+            : [
+                path.resolve(process.cwd(), '.github/context/DCYFR_CONTEXT.json'),
+                path.resolve(process.cwd(), '../../.github/context/DCYFR_CONTEXT.json'),
+                path.resolve(process.cwd(), '../../../.github/context/DCYFR_CONTEXT.json'),
+            ];
+        for (const candidate of candidates) {
+            if (fs.existsSync(candidate)) {
+                const raw = fs.readFileSync(candidate, 'utf-8');
+                const ctx = JSON.parse(raw);
+                if (ctx.brand_voice) {
+                    _cachedBrandVoice = ctx.brand_voice;
+                    return _cachedBrandVoice;
+                }
+            }
+        }
+    }
+    catch {
+        // Intentionally silent — fall through to default
+    }
+    _cachedBrandVoice = DEFAULT_BRAND_VOICE;
+    return DEFAULT_BRAND_VOICE;
+}
+/**
+ * Clears the brand voice cache (useful in tests).
+ */
+export function clearBrandVoiceCache() {
+    _cachedBrandVoice = null;
+}
+// ---------------------------------------------------------------------------
+// VoiceResolver
+// ---------------------------------------------------------------------------
+/**
+ * Resolves the effective voice for an agent by merging workspace brand voice
+ * with persona-specific overrides, then renders a system prompt prefix.
+ *
+ * @param persona - The agent persona to resolve voice for
+ * @param options - Resolver options (tone override, verbosity, etc.)
+ * @returns ResolvedVoice containing the system prompt prefix and metadata
+ *
+ * @example
+ * ```typescript
+ * const voice = resolveVoice(engineerPersona, { verbosity: 2 });
+ * systemPrompt = voice.systemPrefix + '\n\n' + userPrompt;
+ * ```
+ */
+export function resolveVoice(persona, options = {}) {
+    const { enabled = true, tone: toneOverride = null, verbosity = 2, includeTraits = false, brandVoice: brandVoiceOverride = null, } = options;
+    const brandVoice = brandVoiceOverride ?? loadBrandVoice();
+    // Determine applied tone: override > persona > brand default
+    const appliedTone = toneOverride ?? persona.voice_tone ?? brandVoice.tone_spectrum.default;
+    // Determine resolution source for metadata
+    const resolvedFrom = toneOverride ? 'override' : persona.voice_tone ? 'persona' : 'brand';
+    // Merge personality traits
+    const mergedTraits = mergeTraits(brandVoice.core_voice.personality_traits, persona.personality_overrides);
+    if (!enabled) {
+        return {
+            systemPrefix: '',
+            appliedTone,
+            personalityTraits: mergedTraits,
+            agentName: persona.name,
+            metadata: { resolvedFrom, timestamp: new Date().toISOString() },
+        };
+    }
+    // Build system prompt prefix
+    const parts = [];
+    if (verbosity >= 1) {
+        parts.push(renderPersonaBlock(persona));
+    }
+    if (verbosity >= 2) {
+        const toneGuideline = applyToneGuidelines(appliedTone);
+        parts.push(toneGuideline);
+    }
+    if (verbosity >= 3) {
+        const attrs = brandVoice.core_voice.attributes.slice(0, 3);
+        parts.push(`Voice attributes: ${attrs.join('; ')}.`);
+    }
+    if (verbosity >= 4 && includeTraits) {
+        const traitSummary = Object.entries(mergedTraits)
+            .filter(([, v]) => v !== undefined)
+            .map(([k, v]) => `${k}: ${v.toFixed(1)}`)
+            .join(', ');
+        parts.push(`Calibration: [${traitSummary}]`);
+    }
+    if (persona.context_injections?.before_prompt) {
+        parts.push(persona.context_injections.before_prompt);
+    }
+    return {
+        systemPrefix: parts.join('\n'),
+        appliedTone,
+        personalityTraits: mergedTraits,
+        agentName: persona.name,
+        metadata: { resolvedFrom, timestamp: new Date().toISOString() },
+    };
+}
+//# sourceMappingURL=voice-resolver.js.map

package/dist/ai/src/personas/voice-resolver.js.map

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

package/dist/ai/src/resource-monitor.d.ts

@@ -0,0 +1,311 @@
+/**
+ * System Resource Monitor for DCYFR Integration Performance
+ * TLP:CLEAR
+ *
+ * Advanced system resource monitoring for DCYFR integration workflows.
+ * Tracks CPU, memory, I/O, and network resources with intelligent alerting
+ * and optimization recommendations for maximum system performance.
+ *
+ * @version 1.0.0
+ * @date 2026-02-15
+ * @module dcyfr-ai/resource-monitor
+ */
+import { EventEmitter } from 'events';
+import { PerformanceProfiler } from './performance-profiler.js';
+/**
+ * System resource usage snapshot
+ */
+export interface ResourceSnapshot {
+    /**
+     * Snapshot timestamp
+     */
+    timestamp: Date;
+    /**
+     * Memory usage information
+     */
+    memory: {
+        /**
+         * Total system memory (bytes)
+         */
+        total: number;
+        /**
+         * Used memory (bytes)
+         */
+        used: number;
+        /**
+         * Free memory (bytes)
+         */
+        free: number;
+        /**
+         * Memory utilization percentage (0-1)
+         */
+        utilization: number;
+        /**
+         * Process heap usage (bytes)
+         */
+        heapUsed: number;
+        /**
+         * Process heap total (bytes)
+         */
+        heapTotal: number;
+    };
+    /**
+     * CPU usage information
+     */
+    cpu: {
+        /**
+         * CPU utilization percentage (0-1)
+         */
+        utilization: number;
+        /**
+         * Number of CPU cores
+         */
+        cores: number;
+        /**
+         * Load averages [1min, 5min, 15min]
+         */
+        loadAverage: [number, number, number];
+        /**
+         * Process CPU time (milliseconds)
+         */
+        processCpuTime: number;
+    };
+    /**
+     * I/O statistics
+     */
+    io?: {
+        /**
+         * Read operations per second
+         */
+        readOps: number;
+        /**
+         * Write operations per second
+         */
+        writeOps: number;
+        /**
+         * Bytes read per second
+         */
+        readBytes: number;
+        /**
+         * Bytes written per second
+         */
+        writeBytes: number;
+    };
+    /**
+     * Network statistics
+     */
+    network?: {
+        /**
+         * Bytes received per second
+         */
+        bytesReceived: number;
+        /**
+         * Bytes sent per second
+         */
+        bytesSent: number;
+        /**
+         * Active connections
+         */
+        activeConnections: number;
+    };
+}
+/**
+ * Resource alert configuration
+ */
+export interface ResourceAlert {
+    /**
+     * Alert identifier
+     */
+    id: string;
+    /**
+     * Resource type
+     */
+    resource: 'memory' | 'cpu' | 'io' | 'network';
+    /**
+     * Alert threshold (percentage 0-1 or absolute value)
+     */
+    threshold: number;
+    /**
+     * Alert severity
+     */
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    /**
+     * Alert message
+     */
+    message: string;
+    /**
+     * Triggered timestamp
+     */
+    triggeredAt: Date;
+    /**
+     * Resource snapshot when triggered
+     */
+    snapshot: ResourceSnapshot;
+    /**
+     * Alert recommendations
+     */
+    recommendations: string[];
+}
+/**
+ * Resource monitor configuration
+ */
+export interface ResourceMonitorConfig {
+    /**
+     * Monitoring interval in milliseconds
+     */
+    monitoringInterval?: number;
+    /**
+     * Enable alerting
+     */
+    enableAlerting?: boolean;
+    /**
+     * Memory utilization alert threshold (0-1)
+     */
+    memoryAlertThreshold?: number;
+    /**
+     * CPU utilization alert threshold (0-1)
+     */
+    cpuAlertThreshold?: number;
+    /**
+     * Enable I/O monitoring
+     */
+    enableIOMonitoring?: boolean;
+    /**
+     * Enable network monitoring
+     */
+    enableNetworkMonitoring?: boolean;
+    /**
+     * History retention period (milliseconds)
+     */
+    historyRetention?: number;
+    /**
+     * Enable performance optimization recommendations
+     */
+    enableOptimizationRecommendations?: boolean;
+}
+/**
+ * System Resource Monitor
+ *
+ * Comprehensive system resource monitoring with intelligent alerting,
+ * trend analysis, and optimization recommendations for DCYFR workflows.
+ */
+export declare class SystemResourceMonitor extends EventEmitter {
+    private config;
+    private profiler?;
+    private monitoringInterval?;
+    private snapshots;
+    private alerts;
+    private lastCpuUsage;
+    private baselineSnapshot?;
+    private isMonitoring;
+    constructor(config?: ResourceMonitorConfig, profiler?: PerformanceProfiler);
+    /**
+     * Start resource monitoring
+     */
+    startMonitoring(): void;
+    /**
+     * Stop resource monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Collect current resource snapshot
+     */
+    collectSnapshot(): ResourceSnapshot;
+    /**
+     * Create resource snapshot
+     */
+    private createSnapshot;
+    /**
+     * Get memory usage statistics
+     */
+    private getMemoryUsage;
+    /**
+     * Get CPU usage statistics
+     */
+    private getCpuUsage;
+    /**
+     * Get I/O usage statistics (placeholder)
+     */
+    private getIOUsage;
+    /**
+     * Get network usage statistics (placeholder)
+     */
+    private getNetworkUsage;
+    /**
+     * Check for resource alerts
+     */
+    private checkResourceAlerts;
+    /**
+     * Trigger resource alert
+     */
+    private triggerAlert;
+    /**
+     * Generate optimization recommendations based on alert
+     */
+    private generateOptimizationRecommendations;
+    /**
+     * Record metrics in performance profiler
+     */
+    private recordProfilingMetrics;
+    /**
+     * Establish performance baseline
+     */
+    private establishBaseline;
+    /**
+     * Cleanup old snapshots
+     */
+    private cleanupOldSnapshots;
+    /**
+     * Get current resource usage
+     */
+    getCurrentUsage(): ResourceSnapshot | null;
+    /**
+     * Get resource usage history
+     */
+    getUsageHistory(duration?: number): ResourceSnapshot[];
+    /**
+     * Get active alerts
+     */
+    getActiveAlerts(): ResourceAlert[];
+    /**
+     * Get resource usage statistics
+     */
+    getUsageStatistics(): {
+        averageMemoryUtilization: number;
+        averageCpuUtilization: number;
+        maxMemoryUtilization: number;
+        maxCpuUtilization: number;
+        alertCount: number;
+        uptimeHours: number;
+    };
+    /**
+     * Generate resource usage report
+     */
+    generateReport(): {
+        summary: any;
+        alerts: ResourceAlert[];
+        recommendations: string[];
+        charts?: any;
+    };
+    /**
+     * Clear monitoring data
+     */
+    clearData(): void;
+    /**
+     * Shutdown resource monitor
+     */
+    shutdown(): void;
+}
+/**
+ * Get or create global resource monitor instance
+ */
+export declare function getGlobalResourceMonitor(config?: ResourceMonitorConfig, profiler?: PerformanceProfiler): SystemResourceMonitor;
+/**
+ * Monitor resources during workflow execution
+ */
+export declare function monitorWorkflowExecution<T>(workflowFn: () => Promise<T>, config?: ResourceMonitorConfig): Promise<{
+    result: T;
+    resourceReport: any;
+}>;
+export default SystemResourceMonitor;
+//# sourceMappingURL=resource-monitor.d.ts.map

package/dist/ai/src/resource-monitor.d.ts.map

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