@auxiora/personality 1.0.0 → 1.3.1

package/lib/index.js

@@ -0,0 +1,620 @@
+// ────────────────────────────────────────────────────────────────────────────
+// THE ARCHITECT — Full Data Flow (Phases 1–4)
+// ────────────────────────────────────────────────────────────────────────────
+//
+// ┌─ INBOUND ──────────────────────────────────────────────────────────────┐
+// │ User types message in chat UI                                         │
+// │                      ↓                                                │
+// │ Chat service calls architect.generatePrompt(userMessage, history)     │
+// └───────────────────────────────────────────────────────────────────────┘
+//
+// ┌─ CONTEXT DETECTION (Phase 1 + Phase 2 corrections) ───────────────────┐
+// │ 1. detectContext() scores message against 17 domain keyword sets      │
+// │ 2. CorrectionStore checks for learned corrections from past           │
+// │    misclassifications — if a correction matches, it overrides the     │
+// │    auto-detected domain and sets corrected=true, originalDomain       │
+// │ 3. Emotional register inferred (neutral/stressed/frustrated/etc.)     │
+// │ 4. Stakes, complexity, and mode derived from signals                  │
+// │ Result: TaskContext { domain, emotionalRegister, stakes, ... }        │
+// └───────────────────────────────────────────────────────────────────────┘
+//                      ↓
+// ┌─ CONVERSATION THEME (Phase 3) ────────────────────────────────────────┐
+// │ 5. ConversationContext.recordDetection() adds to sliding window       │
+// │ 6. After 3+ consistent detections, a theme locks in                   │
+// │ 7. Brief tangents (< 0.7 confidence) don't break theme               │
+// │ 8. Crisis domains always override regardless of theme                 │
+// │ Result: effectiveDomain (may differ from raw detection)               │
+// └───────────────────────────────────────────────────────────────────────┘
+//                      ↓
+// ┌─ TRAIT MIXING (Phases 1–4) ───────────────────────────────────────────┐
+// │ 9.  baseMix = CONTEXT_PROFILES[effectiveDomain]   (29 traits, 0–1)   │
+// │ 10. adjustedMix = applyEmotionalOverride(baseMix, emotion)           │
+// │     — stressed → +warmth, +stoicCalm, +empathy                       │
+// │     — frustrated → +empathy, +patience, -urgency                     │
+// │     — etc.                                                            │
+// │ 11. EmotionalTracker records intensity, detects trajectory            │
+// │     (stable / escalating / de_escalating / volatile / shifting)       │
+// │ 12. adjustedMix = applyTrajectoryMultipliers(adjustedMix, trajectory)│
+// │     — escalating: 1.2× warmth, empathy, calm                         │
+// │     — volatile: 1.3× warmth, calm                                    │
+// │ 13. adjustedMix = customWeights.apply(adjustedMix)                   │
+// │     — additive offsets [-0.3, +0.3] from user preferences / presets  │
+// │ Result: final TraitMix with all 29 traits modulated                   │
+// └───────────────────────────────────────────────────────────────────────┘
+//                      ↓
+// ┌─ PROMPT ASSEMBLY (Phase 1) ───────────────────────────────────────────┐
+// │ 14. contextModifier = assemblePromptModifier(adjustedMix, context)   │
+// │     — weight-scaled behavioral instructions for each active trait     │
+// │ 15. activeSources = getActiveSources(adjustedMix)                     │
+// │     — provenance: trait → historical mind → source work → evidence   │
+// │ 16. fullPrompt = ARCHITECT_BASE_PROMPT + contextModifier              │
+// │ Result: PromptOutput { fullPrompt, activeTraits, detectedContext }    │
+// └───────────────────────────────────────────────────────────────────────┘
+//                      ↓
+// ┌─ SIDE EFFECTS (Phases 2–3) ───────────────────────────────────────────┐
+// │ 17. Fire-and-forget: persistence.recordUsage(domain)                  │
+// │ 18. Recommender checks for context suggestions:                       │
+// │     — correction_pattern: previously corrected similar messages        │
+// │     — low_confidence: detection score below threshold                  │
+// │     — usage_pattern: unusual domain for this user                     │
+// │ Result: optional ContextRecommendation in output                      │
+// └───────────────────────────────────────────────────────────────────────┘
+//                      ↓
+// ┌─ OUTBOUND ────────────────────────────────────────────────────────────┐
+// │ Runtime sends fullPrompt as system prompt to AI provider              │
+// │ Response displayed in chat UI with:                                   │
+// │   — ContextIndicator pill (domain + emoji)                            │
+// │   — SourcesButton → SourcesPanel (active traits + provenance)         │
+// │   — ContextRecommendation banner (if recommendation present)          │
+// │   — ContextOverrideMenu (user can force a different domain)           │
+// │   — TraitCustomizer (user adjusts trait weights / loads presets)       │
+// │   — ConversationExportButton → JSON / Markdown / CSV download         │
+// └───────────────────────────────────────────────────────────────────────┘
+//
+// ────────────────────────────────────────────────────────────────────────────
+import { ARCHITECT_BASE_PROMPT } from './system-prompt.js';
+import { CONTEXT_PROFILES } from './context-profiles.js';
+import { applyEmotionalOverride } from './emotional-overrides.js';
+import { detectContext } from './context-detector.js';
+import { assemblePromptModifier, getActiveSources } from './prompt-assembler.js';
+import { CorrectionStore } from './correction-store.js';
+import { ArchitectPersistence } from './persistence.js';
+import { ContextRecommender } from './recommender.js';
+import { ConversationContext } from './conversation-context.js';
+import { EmotionalTracker, estimateIntensity } from './emotional-tracker.js';
+import { CustomWeights, WEIGHT_PRESETS } from './custom-weights.js';
+import { ConversationExporter } from './conversation-export.js';
+import { PreferenceHistory } from './preference-history.js';
+import { DecisionLog } from './decision-log.js';
+import { FeedbackStore } from './feedback-store.js';
+import { UserModelSynthesizer } from './user-model-synthesizer.js';
+// Re-export building blocks for advanced consumers
+export { ARCHITECT_BASE_PROMPT } from './system-prompt.js';
+export { CONTEXT_PROFILES } from './context-profiles.js';
+export { EMOTIONAL_OVERRIDES, applyEmotionalOverride } from './emotional-overrides.js';
+export { detectContext, scoreAllDomains } from './context-detector.js';
+export { assemblePromptModifier, getActiveSources } from './prompt-assembler.js';
+export { SOURCE_MAP } from './source-map.js';
+export { TRAIT_TO_INSTRUCTION } from './trait-to-instruction.js';
+export { CorrectionStore } from './correction-store.js';
+export { ContextRecommender } from './recommender.js';
+export { ConversationContext } from './conversation-context.js';
+export { EmotionalTracker, estimateIntensity } from './emotional-tracker.js';
+export { CustomWeights, WEIGHT_PRESETS } from './custom-weights.js';
+export { ConversationExporter } from './conversation-export.js';
+export { ArchitectPersistence } from './persistence.js';
+export { InMemoryEncryptedStorage, VaultStorageAdapter } from './persistence-adapter.js';
+// Phase 5: self-awareness modules
+export { PreferenceHistory } from './preference-history.js';
+export { DecisionLog } from './decision-log.js';
+export { FeedbackStore } from './feedback-store.js';
+export { UserModelSynthesizer } from './user-model-synthesizer.js';
+// ────────────────────────────────────────────────────────────────────────────
+// Domain metadata
+// ────────────────────────────────────────────────────────────────────────────
+const DOMAIN_METADATA = [
+    { domain: 'security_review', label: 'Security Review', description: 'Adversarial analysis, threat modeling, vulnerability assessment' },
+    { domain: 'code_engineering', label: 'Code Engineering', description: 'Writing, refactoring, testing, and deploying code' },
+    { domain: 'architecture_design', label: 'Architecture Design', description: 'System design, trade-off analysis, pattern selection' },
+    { domain: 'debugging', label: 'Debugging', description: 'Root cause analysis, mental execution tracing, fix verification' },
+    { domain: 'team_leadership', label: 'Team Leadership', description: 'Culture building, standard setting, team performance' },
+    { domain: 'one_on_one', label: 'One-on-One', description: 'Personal coaching, career development, empathetic listening' },
+    { domain: 'sales_pitch', label: 'Sales Pitch', description: 'Value communication, transformation framing, objection handling' },
+    { domain: 'negotiation', label: 'Negotiation', description: 'Tactical empathy, position analysis, leverage assessment' },
+    { domain: 'marketing_content', label: 'Marketing Content', description: 'Positioning, messaging, audience-first content creation' },
+    { domain: 'strategic_planning', label: 'Strategic Planning', description: 'Roadmap design, resource allocation, initiative prioritization' },
+    { domain: 'crisis_management', label: 'Crisis Management', description: 'Incident response, stakeholder communication, rapid stabilization' },
+    { domain: 'creative_work', label: 'Creative Work', description: 'Brainstorming, ideation, constraint-driven innovation' },
+    { domain: 'writing_content', label: 'Writing Content', description: 'Drafting, editing, tone calibration, audience-aware prose' },
+    { domain: 'decision_making', label: 'Decision Making', description: 'Option analysis, probability assessment, regret minimization' },
+    { domain: 'personal_development', label: 'Personal Development', description: 'Career pathing, skill development, growth coaching' },
+    { domain: 'learning_research', label: 'Learning & Research', description: 'Concept explanation, deep dives, teaching from first principles' },
+    { domain: 'general', label: 'General', description: 'Balanced baseline for unclassified or mixed-domain conversations' },
+];
+// ────────────────────────────────────────────────────────────────────────────
+// The Architect
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * The Architect personality engine.
+ *
+ * Takes a user message and optional conversation history, detects the
+ * operational context, selects and modulates traits, and assembles a
+ * complete prompt with full provenance for every active trait.
+ *
+ * When constructed with an EncryptedStorage instance, persistence is enabled:
+ * corrections, usage history, and preferences are stored encrypted at rest.
+ * Call `initialize()` once after construction to load persisted state.
+ */
+export class TheArchitect {
+    contextOverride = null;
+    correctionStore;
+    recommender;
+    conversationContext;
+    emotionalTracker;
+    customWeights;
+    preferenceHistory;
+    decisionLog;
+    feedbackStore;
+    persistence;
+    preferences;
+    initialized = false;
+    constructor(storage) {
+        this.correctionStore = new CorrectionStore();
+        this.recommender = new ContextRecommender();
+        this.conversationContext = new ConversationContext();
+        this.emotionalTracker = new EmotionalTracker();
+        this.customWeights = new CustomWeights();
+        this.preferenceHistory = new PreferenceHistory();
+        this.decisionLog = new DecisionLog();
+        this.feedbackStore = new FeedbackStore();
+        if (storage) {
+            this.persistence = new ArchitectPersistence(storage);
+        }
+    }
+    /**
+     * Load persisted state (corrections, preferences, usage history).
+     * Call once after construction. Safe to call multiple times (idempotent).
+     * No-op when persistence is not configured.
+     */
+    async initialize() {
+        if (this.initialized || !this.persistence)
+            return;
+        const prefs = await this.persistence.load();
+        this.correctionStore = CorrectionStore.deserialize(prefs.corrections);
+        this.preferences = prefs;
+        if (prefs.defaultContext) {
+            this.contextOverride = prefs.defaultContext;
+        }
+        if (prefs.customWeights) {
+            this.customWeights = CustomWeights.deserialize(prefs.customWeights);
+        }
+        if (prefs.preferenceHistory) {
+            this.preferenceHistory = PreferenceHistory.deserialize(prefs.preferenceHistory);
+        }
+        if (prefs.decisionLog) {
+            this.decisionLog = DecisionLog.deserialize(prefs.decisionLog);
+        }
+        if (prefs.feedbackStore) {
+            this.feedbackStore = FeedbackStore.deserialize(prefs.feedbackStore);
+        }
+        this.initialized = true;
+    }
+    /**
+     * Primary method: user message in, complete prompt out.
+     *
+     * Detects context, selects the domain profile, applies emotional
+     * overrides, assembles a weight-scaled prompt modifier, and returns
+     * the full prompt with active trait sources for transparency.
+     *
+     * Also records usage asynchronously (fire-and-forget) and checks
+     * the recommender for context suggestions.
+     */
+    generatePrompt(userMessage, history) {
+        const rawContext = this.detectContext(userMessage, history);
+        let context;
+        if (this.contextOverride) {
+            context = { ...rawContext, domain: this.contextOverride, corrected: undefined, originalDomain: undefined };
+        }
+        else {
+            // Apply conversation-level theme awareness
+            const rawDomain = rawContext.domain;
+            const rawConfidence = rawContext.detectionConfidence ?? 0;
+            this.conversationContext.recordDetection(userMessage, rawDomain, rawConfidence);
+            const effectiveDomain = this.conversationContext.getEffectiveDomain(rawDomain, rawConfidence);
+            const theme = this.conversationContext.getSummary().theme;
+            if (effectiveDomain !== rawDomain) {
+                context = {
+                    ...rawContext,
+                    domain: effectiveDomain,
+                    rawDetectedDomain: rawDomain,
+                    themeOverridden: true,
+                    conversationTheme: theme ?? undefined,
+                };
+            }
+            else {
+                context = { ...rawContext, conversationTheme: theme ?? undefined };
+            }
+        }
+        const baseMix = CONTEXT_PROFILES[context.domain];
+        let adjustedMix = applyEmotionalOverride(baseMix, context.emotionalRegister);
+        // Track emotional trajectory and apply trajectory-based multipliers
+        const intensity = estimateIntensity(userMessage, context.emotionalRegister);
+        this.emotionalTracker.recordEmotion(context.emotionalRegister, intensity, userMessage);
+        const effective = this.emotionalTracker.getEffectiveEmotion();
+        adjustedMix = this.applyTrajectoryMultipliers(adjustedMix, effective.trajectory);
+        // Apply user's custom trait weight adjustments (history-aware when available)
+        if (this.preferenceHistory.getTraitHistory('warmth').length > 0 ||
+            Object.keys(this.customWeights.getOverrides()).length > 0) {
+            adjustedMix = this.customWeights.applyWithHistory(adjustedMix, context.domain, this.preferenceHistory);
+        }
+        const modifier = assemblePromptModifier(adjustedMix, context);
+        const sources = getActiveSources(adjustedMix);
+        // Fire-and-forget persistence of usage
+        if (this.persistence) {
+            this.persistence.recordUsage(context.domain).catch(() => { });
+        }
+        // Check for recommendations (only when no manual override is active)
+        let recommendation;
+        if (!this.contextOverride) {
+            const usageHistory = this.preferences?.contextUsageHistory ?? {};
+            recommendation = this.recommender.shouldRecommend(context, this.correctionStore, usageHistory, userMessage) ?? undefined;
+        }
+        // Gather relevant decisions and feedback insights
+        const dueFollowUps = this.decisionLog.getDueFollowUps();
+        const recentDomainDecisions = this.decisionLog.getRecentForDomain(context.domain, 5);
+        const relevantDecisions = [...dueFollowUps, ...recentDomainDecisions.filter(d => !dueFollowUps.some(f => f.id === d.id))];
+        const feedbackInsight = this.feedbackStore.getInsights();
+        const hasFeedbackInsight = feedbackInsight.totalFeedback > 0;
+        return {
+            basePrompt: ARCHITECT_BASE_PROMPT,
+            contextModifier: modifier,
+            fullPrompt: ARCHITECT_BASE_PROMPT + '\n\n' + modifier,
+            activeTraits: sources,
+            detectedContext: context,
+            emotionalTrajectory: effective.trajectory,
+            escalationAlert: effective.escalationAlert || undefined,
+            recommendation,
+            relevantDecisions: relevantDecisions.length > 0 ? relevantDecisions : undefined,
+            feedbackInsight: hasFeedbackInsight ? feedbackInsight : undefined,
+        };
+    }
+    /**
+     * Detects the full task context from a user message and optional
+     * conversation history. Exposed publicly for debugging and testing.
+     */
+    detectContext(userMessage, history) {
+        return detectContext(userMessage, history, this.correctionStore);
+    }
+    /**
+     * Returns the fully modulated trait mix for a given context.
+     * Applies the domain's base profile and then emotional overrides.
+     */
+    getTraitMix(context) {
+        const base = CONTEXT_PROFILES[context.domain];
+        return applyEmotionalOverride(base, context.emotionalRegister);
+    }
+    /** Returns the static base personality prompt. */
+    getBasePrompt() {
+        return ARCHITECT_BASE_PROMPT;
+    }
+    /**
+     * Forces a specific domain regardless of context detection.
+     * Pass `null` to return to automatic detection.
+     */
+    setContextOverride(domain) {
+        this.contextOverride = domain;
+    }
+    /**
+     * Returns all 17 context domains with human-readable labels
+     * and one-line descriptions for UI rendering.
+     */
+    listContextDomains() {
+        return DOMAIN_METADATA;
+    }
+    /**
+     * Returns the active trait sources for the given mix, or for
+     * the general profile if no mix is provided.
+     */
+    getActiveSources(mix) {
+        const m = mix ?? CONTEXT_PROFILES['general'];
+        return getActiveSources(m);
+    }
+    // ── Conversation context ─────────────────────────────────────────────
+    /** Reset conversation context and emotional tracker for a new conversation. */
+    resetConversation() {
+        this.conversationContext.reset();
+        this.emotionalTracker.reset();
+    }
+    /** Get the conversation context summary. */
+    getConversationSummary() {
+        return this.conversationContext.getSummary();
+    }
+    /** Get the current emotional trajectory. */
+    getEmotionalState() {
+        return this.emotionalTracker.getEffectiveEmotion();
+    }
+    // ── Custom weights ───────────────────────────────────────────────────
+    /** Set a custom trait weight offset. Records in preference history and persists. */
+    async setTraitOverride(trait, offset, source = 'user', reason) {
+        this.customWeights.setOverride(trait, offset);
+        this.preferenceHistory.record({
+            trait,
+            offset,
+            context: this.contextOverride,
+            source,
+            reason,
+        });
+        await this.persistCustomWeights();
+    }
+    /** Remove a custom trait weight override. */
+    async removeTraitOverride(trait) {
+        this.customWeights.removeOverride(trait);
+        await this.persistCustomWeights();
+    }
+    /** Load a preset weight configuration. Records each override in preference history. */
+    async loadPreset(presetName) {
+        this.customWeights.loadPreset(presetName);
+        const overrides = this.customWeights.getOverrides();
+        for (const [trait, offset] of Object.entries(overrides)) {
+            this.preferenceHistory.record({
+                trait,
+                offset,
+                context: this.contextOverride,
+                source: 'preset',
+                reason: presetName,
+            });
+        }
+        await this.persistCustomWeights();
+    }
+    /** Returns available weight presets. */
+    listPresets() {
+        return WEIGHT_PRESETS;
+    }
+    /** Returns current custom weight overrides. */
+    getActiveOverrides() {
+        return this.customWeights.getOverrides();
+    }
+    /** Persist custom weights and preference history to encrypted storage. */
+    async persistCustomWeights() {
+        if (!this.persistence)
+            return;
+        const prefs = await this.persistence.load();
+        prefs.customWeights = this.customWeights.serialize();
+        prefs.preferenceHistory = this.preferenceHistory.serialize();
+        await this.persistence.save(prefs);
+        this.preferences = prefs;
+    }
+    // ── Preference history ─────────────────────────────────────────────
+    /** Get conflicts in preference history. */
+    getPreferenceConflicts() {
+        return this.preferenceHistory.detectConflicts();
+    }
+    /** Get preference change history for a trait. */
+    getPreferenceHistory(trait) {
+        return this.preferenceHistory.getTraitHistory(trait);
+    }
+    // ── Decision log ──────────────────────────────────────────────────
+    /** Record a decision for cross-session tracking. */
+    async recordDecision(decision) {
+        const result = this.decisionLog.addDecision(decision);
+        await this.persistDecisionLog();
+        return result;
+    }
+    /** Update a decision's status or outcome. */
+    async updateDecision(id, updates) {
+        this.decisionLog.updateDecision(id, updates);
+        await this.persistDecisionLog();
+    }
+    /** Query decisions with filters. */
+    queryDecisions(q) {
+        return this.decisionLog.query(q);
+    }
+    /** Get decisions due for follow-up. */
+    getDueFollowUps() {
+        return this.decisionLog.getDueFollowUps();
+    }
+    /** Persist decision log to encrypted storage. */
+    async persistDecisionLog() {
+        if (!this.persistence)
+            return;
+        const prefs = await this.persistence.load();
+        prefs.decisionLog = this.decisionLog.serialize();
+        await this.persistence.save(prefs);
+        this.preferences = prefs;
+    }
+    // ── Feedback ──────────────────────────────────────────────────────
+    /** Record feedback on a response. */
+    async recordFeedback(feedback) {
+        this.feedbackStore.addFeedback({
+            domain: feedback.domain,
+            rating: feedback.rating,
+            traitSnapshot: feedback.traitSnapshot ?? {},
+            note: feedback.note,
+        });
+        await this.persistFeedbackStore();
+    }
+    /** Get actionable feedback insights. */
+    getFeedbackInsights() {
+        return this.feedbackStore.getInsights();
+    }
+    /** Get satisfaction trend over recent feedback. */
+    getFeedbackTrend(windowSize) {
+        return this.feedbackStore.getRecentTrend(windowSize);
+    }
+    /** Persist feedback store to encrypted storage. */
+    async persistFeedbackStore() {
+        if (!this.persistence)
+            return;
+        const prefs = await this.persistence.load();
+        prefs.feedbackStore = this.feedbackStore.serialize();
+        await this.persistence.save(prefs);
+        this.preferences = prefs;
+    }
+    // ── User model ───────────────────────────────────────────────────────
+    /** Synthesize a complete user model from all data stores. */
+    getUserModel() {
+        const synthesizer = new UserModelSynthesizer({
+            preferenceHistory: this.preferenceHistory,
+            decisionLog: this.decisionLog,
+            feedbackStore: this.feedbackStore,
+            correctionStore: this.correctionStore,
+            preferences: this.preferences,
+        });
+        return synthesizer.synthesize();
+    }
+    // ── Trajectory multipliers ──────────────────────────────────────────
+    /**
+     * Apply trajectory-based multipliers on top of standard emotional overrides.
+     * Caps all values at 1.0.
+     */
+    applyTrajectoryMultipliers(mix, trajectory) {
+        if (trajectory === 'stable')
+            return mix;
+        const result = { ...mix };
+        const cap = (key, multiplier) => {
+            result[key] = Math.min(result[key] * multiplier, 1.0);
+        };
+        switch (trajectory) {
+            case 'escalating':
+                cap('warmth', 1.2);
+                cap('tacticalEmpathy', 1.2);
+                cap('stoicCalm', 1.2);
+                break;
+            case 'volatile':
+                cap('warmth', 1.3);
+                cap('stoicCalm', 1.3);
+                break;
+            case 'de_escalating':
+                // Gently normalize all override-affected traits
+                for (const key of Object.keys(result)) {
+                    result[key] = Math.min(result[key] * 0.9, 1.0);
+                }
+                break;
+            case 'shifting':
+                // Slightly dampened to smooth the transition
+                for (const key of Object.keys(result)) {
+                    result[key] = Math.min(result[key] * 0.8, 1.0);
+                }
+                break;
+        }
+        return result;
+    }
+    // ── Correction learning ──────────────────────────────────────────────
+    /**
+     * Records a user correction so the engine can learn from misclassifications.
+     * Also persists the updated corrections to encrypted storage when available.
+     */
+    async recordCorrection(userMessage, detectedDomain, correctedDomain) {
+        const emotionalRegister = detectContext(userMessage).emotionalRegister;
+        this.correctionStore.addCorrection({
+            userMessage,
+            messageLength: userMessage.length,
+            detectedDomain,
+            correctedDomain,
+            detectedEmotion: emotionalRegister,
+        });
+        if (this.persistence) {
+            await this.persistence.saveCorrections(this.correctionStore);
+        }
+    }
+    /** Load corrections from serialized data (e.g. from encrypted vault). */
+    loadCorrections(serializedData) {
+        this.correctionStore = CorrectionStore.deserialize(serializedData);
+    }
+    /** Export corrections as a serialized string for encrypted storage. */
+    exportCorrections() {
+        return this.correctionStore.serialize();
+    }
+    /** Get correction statistics for debugging and transparency. */
+    getCorrectionStats() {
+        return this.correctionStore.getStats();
+    }
+    // ── Preferences ───────────────────────────────────────────────────────
+    /** Returns the current preferences. Falls back to in-memory defaults. */
+    async getPreferences() {
+        if (this.persistence) {
+            const prefs = await this.persistence.load();
+            this.preferences = prefs;
+            return prefs;
+        }
+        // Return a default snapshot when no persistence
+        return {
+            corrections: this.correctionStore.serialize(),
+            customWeights: this.customWeights.serialize(),
+            showContextIndicator: true,
+            showSourcesButton: true,
+            autoDetectContext: true,
+            defaultContext: null,
+            contextUsageHistory: {},
+            totalInteractions: 0,
+            firstUsed: 0,
+            lastUsed: 0,
+            version: 2,
+        };
+    }
+    /** Update a single preference and persist. */
+    async updatePreference(key, value) {
+        if (!this.persistence)
+            return;
+        const prefs = await this.persistence.load();
+        prefs[key] = value;
+        await this.persistence.save(prefs);
+        this.preferences = prefs;
+        // Apply side effects
+        if (key === 'defaultContext') {
+            this.contextOverride = value;
+        }
+    }
+    /** Clear all persisted data: corrections, preferences, usage history, and self-awareness stores. */
+    async clearAllData() {
+        this.correctionStore = new CorrectionStore();
+        this.contextOverride = null;
+        this.preferences = undefined;
+        this.conversationContext.reset();
+        this.emotionalTracker.reset();
+        this.customWeights.clear();
+        this.preferenceHistory.clear();
+        this.decisionLog.clear();
+        this.feedbackStore.clear();
+        if (this.persistence) {
+            await this.persistence.clearAll();
+        }
+    }
+    // ── Conversation export ────────────────────────────────────────────
+    /**
+     * Export a conversation with full personality engine metadata.
+     * Returns an ExportedConversation that can be serialized to JSON, Markdown, or CSV.
+     */
+    exportConversation(messages, conversationId) {
+        const exporter = new ConversationExporter();
+        return exporter.export(messages, conversationId);
+    }
+    /**
+     * Export a conversation in the specified format.
+     * @param format - 'json' | 'markdown' | 'csv'
+     */
+    exportConversationAs(messages, conversationId, format) {
+        const exporter = new ConversationExporter();
+        const conversation = exporter.export(messages, conversationId);
+        switch (format) {
+            case 'json': return exporter.toJSON(conversation);
+            case 'markdown': return exporter.toMarkdown(conversation);
+            case 'csv': return exporter.toCSV(conversation);
+        }
+    }
+    /** Export all stored data as JSON string (data portability). */
+    async exportData() {
+        if (this.persistence) {
+            return this.persistence.exportAll();
+        }
+        return JSON.stringify(await this.getPreferences(), null, 2);
+    }
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Convenience factory
+// ────────────────────────────────────────────────────────────────────────────
+/** Creates a new Architect instance, optionally with encrypted persistence. */
+export function createArchitect(storage) {
+    return new TheArchitect(storage);
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}