@auxiora/personality 1.0.0 → 1.3.1

package/lib/the-architect/persistence-adapter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Encrypted storage interface for The Architect's persistence layer.
+ *
+ * Implementations must ensure all stored values are encrypted at rest.
+ * The persistence module stores serialized JSON strings via this interface
+ * and trusts the adapter to handle encryption transparently.
+ */
+export interface EncryptedStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+}
+/**
+ * In-memory implementation of EncryptedStorage for development and testing.
+ * Data is NOT encrypted — use only in non-production environments.
+ */
+export declare class InMemoryEncryptedStorage implements EncryptedStorage {
+    private store;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+}
+/**
+ * Adapter that wraps Auxiora's Vault as an EncryptedStorage implementation.
+ *
+ * The Vault must be unlocked before use. All values are AES-256-GCM encrypted
+ * on disk via the vault's own encryption layer.
+ *
+ * Usage:
+ *   const vault = new Vault();
+ *   await vault.unlock(password);
+ *   const storage = new VaultStorageAdapter(vault);
+ *   const persistence = new ArchitectPersistence(storage);
+ */
+export declare class VaultStorageAdapter implements EncryptedStorage {
+    private vault;
+    constructor(vault: VaultLike);
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+}
+/**
+ * Minimal interface matching Auxiora's Vault class.
+ * Allows the adapter to work without a hard dependency on the vault package.
+ */
+export interface VaultLike {
+    get(name: string): string | undefined;
+    add(name: string, value: string): Promise<void>;
+    remove(name: string): Promise<boolean>;
+    has(name: string): boolean;
+}
+//# sourceMappingURL=persistence-adapter.d.ts.map

package/lib/the-architect/persistence-adapter.js

@@ -0,0 +1,50 @@
+/**
+ * In-memory implementation of EncryptedStorage for development and testing.
+ * Data is NOT encrypted — use only in non-production environments.
+ */
+export class InMemoryEncryptedStorage {
+    store = new Map();
+    async get(key) {
+        return this.store.get(key) ?? null;
+    }
+    async set(key, value) {
+        this.store.set(key, value);
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async exists(key) {
+        return this.store.has(key);
+    }
+}
+/**
+ * Adapter that wraps Auxiora's Vault as an EncryptedStorage implementation.
+ *
+ * The Vault must be unlocked before use. All values are AES-256-GCM encrypted
+ * on disk via the vault's own encryption layer.
+ *
+ * Usage:
+ *   const vault = new Vault();
+ *   await vault.unlock(password);
+ *   const storage = new VaultStorageAdapter(vault);
+ *   const persistence = new ArchitectPersistence(storage);
+ */
+export class VaultStorageAdapter {
+    vault;
+    constructor(vault) {
+        this.vault = vault;
+    }
+    async get(key) {
+        return this.vault.get(key) ?? null;
+    }
+    async set(key, value) {
+        await this.vault.add(key, value);
+    }
+    async delete(key) {
+        await this.vault.remove(key);
+    }
+    async exists(key) {
+        return this.vault.has(key);
+    }
+}
+//# sourceMappingURL=persistence-adapter.js.map

package/lib/the-architect/persistence.d.ts

@@ -0,0 +1,55 @@
+import type { ContextDomain } from '../schema.js';
+import type { EncryptedStorage } from './persistence-adapter.js';
+import { CorrectionStore } from './correction-store.js';
+export interface ArchitectPreferences {
+    /** Serialized CorrectionStore (context detection learning data). */
+    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. */
+    showSourcesButton: boolean;
+    /** Whether to auto-detect context from messages. */
+    autoDetectContext: boolean;
+    /** User-set default context override (null = auto-detect). */
+    defaultContext: ContextDomain | null;
+    /** Per-domain usage counts (local analytics, never transmitted). */
+    contextUsageHistory: Record<ContextDomain, number>;
+    /** Total number of interactions with The Architect. */
+    totalInteractions: number;
+    /** Timestamp of first use. */
+    firstUsed: number;
+    /** Timestamp of last use. */
+    lastUsed: number;
+    /** Schema version for migration support. */
+    version: number;
+}
+export declare class ArchitectPersistence {
+    private storage;
+    private static STORAGE_KEY;
+    constructor(storage: EncryptedStorage);
+    /** Load preferences from encrypted storage. Returns defaults if none exist. */
+    load(): Promise<ArchitectPreferences>;
+    /** Save preferences to encrypted storage. Updates lastUsed automatically. */
+    save(prefs: ArchitectPreferences): Promise<void>;
+    /** Increment usage count for a domain and total interactions. */
+    recordUsage(domain: ContextDomain): Promise<void>;
+    /** Update the corrections field from a CorrectionStore instance. */
+    saveCorrections(store: CorrectionStore): Promise<void>;
+    /** Get the top N most-used context domains, sorted by usage descending. */
+    getMostUsedContexts(topN: number): Promise<ContextDomain[]>;
+    /** Delete all stored Architect data (user privacy). */
+    clearAll(): Promise<void>;
+    /** Export all data as JSON string (user data portability). */
+    exportAll(): Promise<string>;
+    /** Handle version upgrades for stored preferences. */
+    private migrate;
+}
+//# sourceMappingURL=persistence.d.ts.map

package/lib/the-architect/persistence.js

@@ -0,0 +1,123 @@
+import { CorrectionStore } from './correction-store.js';
+// ────────────────────────────────────────────────────────────────────────────
+// Constants
+// ────────────────────────────────────────────────────────────────────────────
+const CURRENT_VERSION = 2;
+const ALL_DOMAINS = [
+    'security_review', 'code_engineering', 'architecture_design', 'debugging',
+    'team_leadership', 'one_on_one', 'sales_pitch', 'negotiation',
+    'marketing_content', 'strategic_planning', 'crisis_management',
+    'creative_work', 'writing_content', 'decision_making',
+    'learning_research', 'personal_development', 'general',
+];
+function emptyUsageHistory() {
+    const history = {};
+    for (const domain of ALL_DOMAINS) {
+        history[domain] = 0;
+    }
+    return history;
+}
+function createDefaults() {
+    const now = Date.now();
+    return {
+        corrections: new CorrectionStore().serialize(),
+        showContextIndicator: true,
+        showSourcesButton: true,
+        autoDetectContext: true,
+        defaultContext: null,
+        contextUsageHistory: emptyUsageHistory(),
+        totalInteractions: 0,
+        firstUsed: now,
+        lastUsed: now,
+        version: CURRENT_VERSION,
+    };
+}
+// ────────────────────────────────────────────────────────────────────────────
+// ArchitectPersistence
+// ────────────────────────────────────────────────────────────────────────────
+export class ArchitectPersistence {
+    storage;
+    static STORAGE_KEY = 'architect_preferences';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /** Load preferences from encrypted storage. Returns defaults if none exist. */
+    async load() {
+        const raw = await this.storage.get(ArchitectPersistence.STORAGE_KEY);
+        if (raw === null) {
+            return createDefaults();
+        }
+        const prefs = JSON.parse(raw);
+        return this.migrate(prefs);
+    }
+    /** Save preferences to encrypted storage. Updates lastUsed automatically. */
+    async save(prefs) {
+        prefs.lastUsed = Date.now();
+        await this.storage.set(ArchitectPersistence.STORAGE_KEY, JSON.stringify(prefs));
+    }
+    /** Increment usage count for a domain and total interactions. */
+    async recordUsage(domain) {
+        const prefs = await this.load();
+        prefs.contextUsageHistory[domain] = (prefs.contextUsageHistory[domain] ?? 0) + 1;
+        prefs.totalInteractions++;
+        await this.save(prefs);
+    }
+    /** Update the corrections field from a CorrectionStore instance. */
+    async saveCorrections(store) {
+        const prefs = await this.load();
+        prefs.corrections = store.serialize();
+        await this.save(prefs);
+    }
+    /** Get the top N most-used context domains, sorted by usage descending. */
+    async getMostUsedContexts(topN) {
+        const prefs = await this.load();
+        return Object.entries(prefs.contextUsageHistory)
+            .filter(([, count]) => count > 0)
+            .sort(([, a], [, b]) => b - a)
+            .slice(0, topN)
+            .map(([domain]) => domain);
+    }
+    /** Delete all stored Architect data (user privacy). */
+    async clearAll() {
+        await this.storage.delete(ArchitectPersistence.STORAGE_KEY);
+    }
+    /** Export all data as JSON string (user data portability). */
+    async exportAll() {
+        const prefs = await this.load();
+        return JSON.stringify(prefs, null, 2);
+    }
+    /** Handle version upgrades for stored preferences. */
+    async migrate(prefs) {
+        if (prefs.version === CURRENT_VERSION) {
+            return prefs;
+        }
+        // Version 0 → 1: add missing fields with defaults
+        if (prefs.version === 0 || prefs.version === undefined) {
+            const defaults = createDefaults();
+            prefs.showContextIndicator ??= defaults.showContextIndicator;
+            prefs.showSourcesButton ??= defaults.showSourcesButton;
+            prefs.autoDetectContext ??= defaults.autoDetectContext;
+            prefs.defaultContext ??= defaults.defaultContext;
+            prefs.contextUsageHistory ??= defaults.contextUsageHistory;
+            prefs.totalInteractions ??= defaults.totalInteractions;
+            prefs.firstUsed ??= defaults.firstUsed;
+            prefs.lastUsed ??= defaults.lastUsed;
+            prefs.corrections ??= defaults.corrections;
+            // Ensure all domains exist in usage history
+            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);
+        return prefs;
+    }
+}
+//# sourceMappingURL=persistence.js.map

package/lib/the-architect/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

package/lib/the-architect/preference-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-history.d.ts","sourceRoot":"","sources":["preference-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAM5D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,QAAQ,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,QAAQ,CAAC;IACtB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC;CACjC;AAmBD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,UAAU,CAAO;IAIzB,oEAAoE;IACpE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,IAAI;IASvD;;;;;;;;OAQG;IACH,kBAAkB,CAChB,KAAK,EAAE,MAAM,QAAQ,EACrB,aAAa,CAAC,EAAE,aAAa,GAC5B,MAAM;IA0CT;;;OAGG;IACH,eAAe,IAAI,kBAAkB,EAAE;IAoCvC,2DAA2D;IAC3D,eAAe,CAAC,KAAK,EAAE,MAAM,QAAQ,GAAG,eAAe,EAAE;IAQzD,uCAAuC;IACvC,SAAS,IAAI,MAAM;IAInB,8EAA8E;IAC9E,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAqBnD,yDAAyD;IACzD,KAAK,IAAI,IAAI;CAGd"}

package/lib/the-architect/preference-history.js

@@ -0,0 +1,132 @@
+// ────────────────────────────────────────────────────────────────────────────
+// Constants
+// ────────────────────────────────────────────────────────────────────────────
+/** Exponential decay factor per entry (most recent = 1, next = 0.8, etc.). */
+const RECENCY_DECAY = 0.8;
+/** Entries older than this (ms) decay to 10 % weight. */
+const AGE_THRESHOLD_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+/** Minimum weight for entries older than AGE_THRESHOLD_MS. */
+const OLD_ENTRY_WEIGHT = 0.1;
+// ────────────────────────────────────────────────────────────────────────────
+// PreferenceHistory
+// ────────────────────────────────────────────────────────────────────────────
+export class PreferenceHistory {
+    entries = [];
+    maxEntries = 200;
+    // ── Record ──────────────────────────────────────────────────────────────
+    /** Record a preference change (called by CustomWeights wrapper). */
+    record(entry) {
+        this.entries.push({ ...entry, timestamp: Date.now() });
+        if (this.entries.length > this.maxEntries) {
+            this.entries = this.entries.slice(this.entries.length - this.maxEntries);
+        }
+    }
+    // ── Effective offset ────────────────────────────────────────────────────
+    /**
+     * 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, currentDomain) {
+        const traitEntries = this.entries.filter(e => e.trait === trait);
+        if (traitEntries.length === 0)
+            return 0;
+        // Strategy 1: context-scoped match
+        if (currentDomain) {
+            const contextEntries = traitEntries.filter(e => e.context === currentDomain);
+            if (contextEntries.length > 0) {
+                // Use the most recent context-scoped entry
+                return contextEntries[contextEntries.length - 1].offset;
+            }
+        }
+        // Strategy 2: recency-weighted average
+        const now = Date.now();
+        const sorted = [...traitEntries].sort((a, b) => b.timestamp - a.timestamp); // most recent first
+        let weightedSum = 0;
+        let totalWeight = 0;
+        for (let i = 0; i < sorted.length; i++) {
+            let weight = Math.pow(RECENCY_DECAY, i);
+            // Age decay: entries older than 30 days get capped at 10 %
+            const ageMs = now - sorted[i].timestamp;
+            if (ageMs > AGE_THRESHOLD_MS) {
+                weight *= OLD_ENTRY_WEIGHT;
+            }
+            weightedSum += sorted[i].offset * weight;
+            totalWeight += weight;
+        }
+        return totalWeight > 0 ? weightedSum / totalWeight : 0;
+    }
+    // ── Conflict detection ──────────────────────────────────────────────────
+    /**
+     * Detect conflicts: entries for the same trait that pull in opposite
+     * directions. Returns conflicts with the resolved value and strategy used.
+     */
+    detectConflicts() {
+        const byTrait = new Map();
+        for (const entry of this.entries) {
+            const existing = byTrait.get(entry.trait);
+            if (existing) {
+                existing.push(entry);
+            }
+            else {
+                byTrait.set(entry.trait, [entry]);
+            }
+        }
+        const conflicts = [];
+        for (const [trait, entries] of byTrait) {
+            if (entries.length < 2)
+                continue;
+            const hasPositive = entries.some(e => e.offset > 0);
+            const hasNegative = entries.some(e => e.offset < 0);
+            if (hasPositive && hasNegative) {
+                const resolution = this.getEffectiveOffset(trait);
+                conflicts.push({
+                    trait,
+                    entries: [...entries],
+                    resolution,
+                    strategy: 'recency',
+                });
+            }
+        }
+        return conflicts;
+    }
+    // ── Trait history ───────────────────────────────────────────────────────
+    /** Get history for a specific trait, most recent first. */
+    getTraitHistory(trait) {
+        return this.entries
+            .filter(e => e.trait === trait)
+            .sort((a, b) => b.timestamp - a.timestamp);
+    }
+    // ── Serialization ─────────────────────────────────────────────────────
+    /** Serialize for encrypted storage. */
+    serialize() {
+        return JSON.stringify({ entries: this.entries });
+    }
+    /** Deserialize from encrypted storage. Validates entry shapes defensively. */
+    static deserialize(data) {
+        const history = new PreferenceHistory();
+        try {
+            const parsed = JSON.parse(data);
+            if (Array.isArray(parsed.entries)) {
+                history.entries = parsed.entries.filter((e) => typeof e === 'object' && e !== null &&
+                    typeof e.trait === 'string' &&
+                    typeof e.offset === 'number' &&
+                    typeof e.timestamp === 'number');
+            }
+        }
+        catch {
+            // Corrupt data — return empty history
+        }
+        return history;
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────────────
+    /** Clear all preference history (user data deletion). */
+    clear() {
+        this.entries = [];
+    }
+}
+//# sourceMappingURL=preference-history.js.map

package/lib/the-architect/preference-history.js.map

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

package/lib/the-architect/prompt-assembler.d.ts

@@ -0,0 +1,16 @@
+import type { TraitMix, TaskContext, TraitSource } from '../schema.js';
+/**
+ * Assembles a context-specific prompt modifier from the current trait mix.
+ *
+ * Selects the top 10 weighted traits, generates a weight-scaled behavioral
+ * instruction for each, and composes them into a prompt block that sits
+ * between the base personality prompt and the user message.
+ */
+export declare function assemblePromptModifier(mix: TraitMix, context: TaskContext): string;
+/**
+ * Returns the SOURCE_MAP entries for the top N weighted traits in the mix.
+ * Useful for transparency — explaining *why* the personality is behaving
+ * a certain way and which historical minds are driving the response.
+ */
+export declare function getActiveSources(mix: TraitMix, topN?: number): TraitSource[];
+//# sourceMappingURL=prompt-assembler.d.ts.map

package/lib/the-architect/prompt-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-assembler.d.ts","sourceRoot":"","sources":["prompt-assembler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQvE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CA6BlF;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,GAAE,MAAW,GAAG,WAAW,EAAE,CAQhF"}

package/lib/the-architect/prompt-assembler.js

@@ -0,0 +1,66 @@
+import { TRAIT_TO_INSTRUCTION } from './trait-to-instruction.js';
+import { SOURCE_MAP } from './source-map.js';
+// ────────────────────────────────────────────────────────────────────────────
+// Prompt modifier assembly
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Assembles a context-specific prompt modifier from the current trait mix.
+ *
+ * Selects the top 10 weighted traits, generates a weight-scaled behavioral
+ * instruction for each, and composes them into a prompt block that sits
+ * between the base personality prompt and the user message.
+ */
+export function assemblePromptModifier(mix, context) {
+    const entries = Object.entries(mix);
+    // Sort by weight descending, take top 10
+    const top = entries
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10);
+    const instructions = [];
+    for (const [key, value] of top) {
+        const fn = TRAIT_TO_INSTRUCTION[key];
+        if (fn) {
+            instructions.push(fn(value, context));
+        }
+    }
+    return [
+        '## Current Context Adaptation',
+        '',
+        `You are operating in a **${formatDomain(context.domain)}** context.`,
+        `The user's emotional state appears **${context.emotionalRegister}**.`,
+        `Stakes: **${context.stakes}**. Complexity: **${context.complexity}**.`,
+        '',
+        'For this interaction, emphasize:',
+        '',
+        ...instructions.map((i) => `- ${i}`),
+        '',
+        `Tone: warmth=${mix.warmth.toFixed(1)}, urgency=${mix.urgency.toFixed(1)}, humor=${mix.humor.toFixed(1)}, depth=${mix.verbosity.toFixed(1)}`,
+    ].join('\n');
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Active source retrieval
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Returns the SOURCE_MAP entries for the top N weighted traits in the mix.
+ * Useful for transparency — explaining *why* the personality is behaving
+ * a certain way and which historical minds are driving the response.
+ */
+export function getActiveSources(mix, topN = 10) {
+    const entries = Object.entries(mix);
+    return entries
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, topN)
+        .map(([key]) => SOURCE_MAP[key])
+        .filter(Boolean);
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ────────────────────────────────────────────────────────────────────────────
+/** Converts a snake_case domain key to a human-readable label. */
+function formatDomain(domain) {
+    return domain
+        .split('_')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=prompt-assembler.js.map

package/lib/the-architect/prompt-assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-assembler.js","sourceRoot":"","sources":["prompt-assembler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAa,EAAE,OAAoB;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAoC,CAAC;IAEvE,yCAAyC;IACzC,MAAM,GAAG,GAAG,OAAO;SAChB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,EAAE,EAAE,CAAC;YACP,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO;QACL,+BAA+B;QAC/B,EAAE;QACF,4BAA4B,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa;QACrE,wCAAwC,OAAO,CAAC,iBAAiB,KAAK;QACtE,aAAa,OAAO,CAAC,MAAM,qBAAqB,OAAO,CAAC,UAAU,KAAK;QACvE,EAAE;QACF,kCAAkC;QAClC,EAAE;QACF,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,EAAE;QACF,gBAAgB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;KAC7I,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAa,EAAE,OAAe,EAAE;IAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAoC,CAAC;IAEvE,OAAO,OAAO;SACX,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;SACd,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SAC/B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,kEAAkE;AAClE,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,MAAM;SACV,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/lib/the-architect/recommender.d.ts

@@ -0,0 +1,25 @@
+import type { TaskContext, ContextDomain } from '../schema.js';
+import type { CorrectionStore } from './correction-store.js';
+export interface ContextRecommendation {
+    suggestedDomain: ContextDomain;
+    reason: string;
+    confidence: number;
+    source: 'correction_pattern' | 'low_confidence' | 'usage_pattern';
+}
+export declare class ContextRecommender {
+    /**
+     * Analyze the detected context and determine if a recommendation should
+     * be shown. Returns null if auto-detection seems right; otherwise returns
+     * a recommendation with a human-readable reason and confidence score.
+     *
+     * Priority order:
+     * 1. Correction-based (learned from user overrides)
+     * 2. Low-confidence (ambiguous detection, close runner-up)
+     * 3. Usage-pattern (general detected but history is concentrated)
+     */
+    shouldRecommend(detectedContext: TaskContext, correctionStore: CorrectionStore, usageHistory: Record<ContextDomain, number>, userMessage?: string): ContextRecommendation | null;
+    private correctionBased;
+    private lowConfidence;
+    private usagePattern;
+}
+//# sourceMappingURL=recommender.d.ts.map