@auxiora/personality 1.3.0 → 1.10.0

package/lib/index.js

@@ -1,486 +1,34 @@
 // ────────────────────────────────────────────────────────────────────────────
-// 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         │
-// └───────────────────────────────────────────────────────────────────────┘
+// Personality engine barrel export
 //
-// ────────────────────────────────────────────────────────────────────────────
-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';
-// 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';
-// ────────────────────────────────────────────────────────────────────────────
-// 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;
-    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();
-        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);
-        }
-        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 (additive offsets)
-        adjustedMix = this.customWeights.apply(adjustedMix);
-        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;
-        }
-        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,
-        };
-    }
-    /**
-     * 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. Persists if storage is available. */
-    async setTraitOverride(trait, offset) {
-        this.customWeights.setOverride(trait, offset);
-        await this.persistCustomWeights();
-    }
-    /** Remove a custom trait weight override. */
-    async removeTraitOverride(trait) {
-        this.customWeights.removeOverride(trait);
-        await this.persistCustomWeights();
-    }
-    /** Load a preset weight configuration. */
-    async loadPreset(presetName) {
-        this.customWeights.loadPreset(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 to encrypted storage. */
-    async persistCustomWeights() {
-        if (!this.persistence)
-            return;
-        const prefs = await this.persistence.load();
-        prefs.customWeights = this.customWeights.serialize();
-        await this.persistence.save(prefs);
-        this.preferences = prefs;
-    }
-    // ── 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: 1,
-        };
-    }
-    /** 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. */
-    async clearAllData() {
-        this.correctionStore = new CorrectionStore();
-        this.contextOverride = null;
-        this.preferences = undefined;
-        this.conversationContext.reset();
-        this.emotionalTracker.reset();
-        this.customWeights.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);
-}
+// Re-exports everything consumers need from the personality engine.
+// Organized by phase so downstream packages can import from a single path:
+//   import { createArchitect, type TraitMix } from '@auxiora/personality/architect';
+// ────────────────────────────────────────────────────────────────────────────
+// Phase 1: core engine
+export { TheArchitect, createArchitect } from './the-architect/index.js';
+export { ARCHITECT_BASE_PROMPT } from './the-architect/system-prompt.js';
+export { CONTEXT_PROFILES } from './the-architect/context-profiles.js';
+export { SOURCE_MAP } from './the-architect/source-map.js';
+export { TRAIT_TO_INSTRUCTION } from './the-architect/trait-to-instruction.js';
+export { detectContext, scoreAllDomains } from './the-architect/context-detector.js';
+export { assemblePromptModifier, getActiveSources } from './the-architect/prompt-assembler.js';
+export { EMOTIONAL_OVERRIDES, applyEmotionalOverride } from './the-architect/emotional-overrides.js';
+// Phase 2: correction learning
+export { CorrectionStore } from './the-architect/correction-store.js';
+// Phase 3: persistence, recommendations, settings
+export { InMemoryEncryptedStorage, VaultStorageAdapter } from './the-architect/persistence-adapter.js';
+export { ArchitectPersistence } from './the-architect/persistence.js';
+export { ContextRecommender } from './the-architect/recommender.js';
+export { ConversationContext } from './the-architect/conversation-context.js';
+export { EmotionalTracker, estimateIntensity } from './the-architect/emotional-tracker.js';
+// Phase 4: custom weights, conversation export
+export { CustomWeights, WEIGHT_PRESETS } from './the-architect/custom-weights.js';
+export { ConversationExporter } from './the-architect/conversation-export.js';
+// Phase 5: self-awareness modules
+export { PreferenceHistory } from './the-architect/preference-history.js';
+export { DecisionLog } from './the-architect/decision-log.js';
+export { FeedbackStore } from './the-architect/feedback-store.js';
+// Phase 5: user model synthesizer
+export { UserModelSynthesizer } from './the-architect/user-model-synthesizer.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mCAAmC;AACnC,EAAE;AACF,oEAAoE;AACpE,2EAA2E;AAC3E,qFAAqF;AACrF,+EAA+E;AAE/E,uBAAuB;AACvB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAYrG,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAGtE,kDAAkD;AAClD,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAEvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAG3F,+CAA+C;AAC/C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAG9E,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGlE,kCAAkC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC"}

package/lib/persistence.d.ts

@@ -6,6 +6,12 @@ export interface ArchitectPreferences {
     corrections: string;
     /** Serialized CustomWeights (user trait adjustments). */
     customWeights?: string;
+    /** Serialized PreferenceHistory (timestamped preference changes). */
+    preferenceHistory?: string;
+    /** Serialized DecisionLog (cross-session decision tracking). */
+    decisionLog?: string;
+    /** Serialized FeedbackStore (response feedback collection). */
+    feedbackStore?: string;
     /** Whether to show the context indicator pill in the chat UI. */
     showContextIndicator: boolean;
     /** Whether to show the sources/provenance button in the chat UI. */

package/lib/persistence.js

@@ -2,7 +2,7 @@ import { CorrectionStore } from './correction-store.js';
 // ────────────────────────────────────────────────────────────────────────────
 // Constants
 // ────────────────────────────────────────────────────────────────────────────
-const CURRENT_VERSION = 1;
+const CURRENT_VERSION = 2;
 const ALL_DOMAINS = [
     'security_review', 'code_engineering', 'architecture_design', 'debugging',
     'team_leadership', 'one_on_one', 'sales_pitch', 'negotiation',
@@ -107,9 +107,16 @@ export class ArchitectPersistence {
             for (const domain of ALL_DOMAINS) {
                 prefs.contextUsageHistory[domain] ??= 0;
             }
+            prefs.version = 1;
+        }
+        // Version 1 → 2: add self-awareness modules (preference history, decision log, feedback store)
+        if (prefs.version === 1) {
+            prefs.preferenceHistory ??= undefined;
+            prefs.decisionLog ??= undefined;
+            prefs.feedbackStore ??= undefined;
             prefs.version = CURRENT_VERSION;
-            await this.save(prefs);
         }
+        await this.save(prefs);
         return prefs;
     }
 }

package/lib/preference-history.d.ts

@@ -0,0 +1,45 @@
+import type { TraitMix, ContextDomain } from '../schema.js';
+export interface PreferenceEntry {
+    trait: keyof TraitMix;
+    offset: number;
+    timestamp: number;
+    context: ContextDomain | null;
+    source: 'user' | 'preset' | 'feedback';
+    reason?: string;
+}
+export interface PreferenceConflict {
+    trait: keyof TraitMix;
+    entries: PreferenceEntry[];
+    resolution: number;
+    strategy: 'recency' | 'context';
+}
+export declare class PreferenceHistory {
+    private entries;
+    private maxEntries;
+    /** Record a preference change (called by CustomWeights wrapper). */
+    record(entry: Omit<PreferenceEntry, 'timestamp'>): void;
+    /**
+     * Get the effective offset for a trait, using recency-weighted resolution.
+     *
+     * 1. If a context-scoped entry exists for the current domain, use it
+     *    (strategy: 'context').
+     * 2. Otherwise, use exponential recency weighting: recent entries count
+     *    more (decay factor 0.8 per entry) (strategy: 'recency').
+     * 3. Entries older than 30 days decay to 10 % weight.
+     */
+    getEffectiveOffset(trait: keyof TraitMix, currentDomain?: ContextDomain): number;
+    /**
+     * Detect conflicts: entries for the same trait that pull in opposite
+     * directions. Returns conflicts with the resolved value and strategy used.
+     */
+    detectConflicts(): PreferenceConflict[];
+    /** Get history for a specific trait, most recent first. */
+    getTraitHistory(trait: keyof TraitMix): PreferenceEntry[];
+    /** Serialize for encrypted storage. */
+    serialize(): string;
+    /** Deserialize from encrypted storage. Validates entry shapes defensively. */
+    static deserialize(data: string): PreferenceHistory;
+    /** Clear all preference history (user data deletion). */
+    clear(): void;
+}
+//# sourceMappingURL=preference-history.d.ts.map