@nexus-cortex/core 4.26.0

package/dist/config/MentorshipConfigService.js

@@ -0,0 +1,318 @@
+/**
+ * Mentorship Config Service
+ *
+ * Implements ConfigService for mentorship settings.
+ * Provides a menu definition that can be rendered by any CLI UI.
+ */
+import { createStandardActions } from '../ui/menu-types.js';
+import { SettingsLoader } from './SettingsLoader.js';
+import { SettingsWriter } from './SettingsWriter.js';
+import { SETTINGS_METADATA, DEFAULT_SETTINGS } from './SettingsSchema.js';
+/**
+ * Map of config keys to environment variable keys
+ */
+const CONFIG_KEY_MAP = {
+    enabled: 'MENTORSHIP_ENABLED',
+    triggerOnError: 'MENTORSHIP_TRIGGER_ON_ERROR',
+    errorThreshold: 'MENTORSHIP_ERROR_THRESHOLD',
+    keywordsEnabled: 'MENTORSHIP_KEYWORDS_ENABLED',
+    customKeywords: 'MENTORSHIP_CUSTOM_KEYWORDS',
+    helperModel: 'MENTORSHIP_HELPER_MODEL',
+    turnBasedEnabled: 'MENTORSHIP_TURN_BASED_ENABLED',
+    turnInterval: 'MENTORSHIP_TURN_INTERVAL',
+    interleavedThinking: 'MENTORSHIP_INTERLEAVED_THINKING',
+    patternDetection: 'MENTORSHIP_PATTERN_DETECTION',
+    patternThreshold: 'MENTORSHIP_PATTERN_THRESHOLD'
+};
+/**
+ * Reverse map: env key to config key
+ */
+const ENV_KEY_MAP = Object.entries(CONFIG_KEY_MAP)
+    .reduce((acc, [configKey, envKey]) => {
+    acc[envKey] = configKey;
+    return acc;
+}, {});
+/**
+ * MentorshipConfigService implements ConfigService for mentorship settings
+ */
+export class MentorshipConfigService {
+    loader;
+    writer;
+    constructor(projectPath = process.cwd()) {
+        this.loader = new SettingsLoader(projectPath);
+        this.writer = new SettingsWriter(projectPath);
+    }
+    /**
+     * Get current mentorship configuration
+     */
+    getConfig() {
+        const env = this.loader.getEnvironment();
+        return {
+            enabled: env.MENTORSHIP_ENABLED === 'true',
+            triggerOnError: env.MENTORSHIP_TRIGGER_ON_ERROR === 'true',
+            errorThreshold: env.MENTORSHIP_ERROR_THRESHOLD,
+            keywordsEnabled: env.MENTORSHIP_KEYWORDS_ENABLED === 'true',
+            customKeywords: env.MENTORSHIP_CUSTOM_KEYWORDS,
+            helperModel: env.MENTORSHIP_HELPER_MODEL,
+            turnBasedEnabled: env.MENTORSHIP_TURN_BASED_ENABLED === 'true',
+            turnInterval: parseInt(env.MENTORSHIP_TURN_INTERVAL) || 10,
+            interleavedThinking: env.MENTORSHIP_INTERLEAVED_THINKING === 'true',
+            patternDetection: env.MENTORSHIP_PATTERN_DETECTION === 'true',
+            patternThreshold: parseInt(env.MENTORSHIP_PATTERN_THRESHOLD) || 3
+        };
+    }
+    /**
+     * Update mentorship configuration
+     */
+    async setConfig(config) {
+        const updates = {};
+        for (const [key, value] of Object.entries(config)) {
+            const envKey = CONFIG_KEY_MAP[key];
+            if (envKey && value !== undefined) {
+                if (typeof value === 'boolean') {
+                    updates[envKey] = value ? 'true' : 'false';
+                }
+                else if (typeof value === 'number') {
+                    updates[envKey] = value.toString();
+                }
+                else {
+                    updates[envKey] = value;
+                }
+            }
+        }
+        this.writer.update(updates);
+        this.loader.reload();
+    }
+    /**
+     * Get a single config value
+     */
+    getValue(key) {
+        return this.getConfig()[key];
+    }
+    /**
+     * Set a single config value
+     */
+    async setValue(key, value) {
+        await this.setConfig({ [key]: value });
+    }
+    /**
+     * Generate menu definition from settings metadata
+     */
+    getMenuDefinition() {
+        const mentorshipMetadata = SETTINGS_METADATA.filter(m => m.category === 'mentorship');
+        // Group items into sections
+        const sections = [
+            {
+                id: 'master',
+                title: 'Master Controls',
+                icon: '!',
+                items: this.createMenuItems(mentorshipMetadata.filter(m => m.key === 'MENTORSHIP_ENABLED' || m.key === 'MENTORSHIP_HELPER_MODEL'))
+            },
+            {
+                id: 'triggers',
+                title: 'Error Triggers',
+                description: 'Configure when mentorship activates',
+                items: this.createMenuItems(mentorshipMetadata.filter(m => m.key === 'MENTORSHIP_TRIGGER_ON_ERROR' ||
+                    m.key === 'MENTORSHIP_ERROR_THRESHOLD' ||
+                    m.key === 'MENTORSHIP_PATTERN_DETECTION' ||
+                    m.key === 'MENTORSHIP_PATTERN_THRESHOLD'))
+            },
+            {
+                id: 'keywords',
+                title: 'Keyword Triggers',
+                description: 'Manual activation via @keywords',
+                items: this.createMenuItems(mentorshipMetadata.filter(m => m.key === 'MENTORSHIP_KEYWORDS_ENABLED' ||
+                    m.key === 'MENTORSHIP_CUSTOM_KEYWORDS'))
+            },
+            {
+                id: 'periodic',
+                title: 'Periodic Review',
+                description: 'Automatic turn-based mentorship',
+                items: this.createMenuItems(mentorshipMetadata.filter(m => m.key === 'MENTORSHIP_TURN_BASED_ENABLED' ||
+                    m.key === 'MENTORSHIP_TURN_INTERVAL'))
+            },
+            {
+                id: 'advanced',
+                title: 'Advanced',
+                collapsed: true,
+                items: this.createMenuItems(mentorshipMetadata.filter(m => m.key === 'MENTORSHIP_INTERLEAVED_THINKING'))
+            }
+        ];
+        return {
+            id: 'mentorship',
+            title: 'Mentorship Configuration',
+            description: 'Configure AI-to-AI reactive mentorship system',
+            icon: '#',
+            sections: sections.filter(s => s.items.length > 0),
+            actions: createStandardActions(),
+            footer: 'Arrow keys: navigate | Space/Enter: toggle | s: save | r: reset | Esc: cancel'
+        };
+    }
+    /**
+     * Create menu items from settings metadata
+     */
+    createMenuItems(metadata) {
+        const config = this.getConfig();
+        return metadata.map(m => {
+            const configKey = ENV_KEY_MAP[m.key];
+            const currentValue = configKey ? config[configKey] : undefined;
+            switch (m.type) {
+                case 'boolean':
+                    return {
+                        type: 'toggle',
+                        key: m.key,
+                        label: m.displayName,
+                        description: m.description,
+                        value: currentValue === true,
+                        liveUpdate: true
+                    };
+                case 'choice':
+                    return {
+                        type: 'select',
+                        key: m.key,
+                        label: m.displayName,
+                        description: m.description,
+                        value: currentValue || m.default || '',
+                        choices: (m.choices || []).map(c => ({
+                            label: c,
+                            value: c
+                        })),
+                        liveUpdate: true
+                    };
+                case 'number':
+                    return {
+                        type: 'number',
+                        key: m.key,
+                        label: m.displayName,
+                        description: m.description,
+                        value: typeof currentValue === 'number' ? currentValue : parseInt(m.default || '0'),
+                        min: m.key === 'MENTORSHIP_TURN_INTERVAL' ? 1 : 2,
+                        max: m.key === 'MENTORSHIP_TURN_INTERVAL' ? 50 : 10,
+                        liveUpdate: false
+                    };
+                case 'string':
+                    return {
+                        type: 'text',
+                        key: m.key,
+                        label: m.displayName,
+                        description: m.description,
+                        value: currentValue || m.default || '',
+                        placeholder: m.description,
+                        liveUpdate: false
+                    };
+                default:
+                    return {
+                        type: 'info',
+                        key: m.key,
+                        label: m.displayName,
+                        description: m.description,
+                        value: String(currentValue || m.default || '')
+                    };
+            }
+        });
+    }
+    /**
+     * Validate a value for a given key
+     */
+    validateValue(key, value) {
+        const metadata = SETTINGS_METADATA.find(m => m.key === key);
+        if (!metadata) {
+            return { valid: true };
+        }
+        // Type validation
+        if (metadata.type === 'boolean' && typeof value !== 'boolean') {
+            return { valid: false, error: 'Must be true or false' };
+        }
+        if (metadata.type === 'number') {
+            const num = typeof value === 'number' ? value : parseInt(String(value));
+            if (isNaN(num)) {
+                return { valid: false, error: 'Must be a number' };
+            }
+        }
+        if (metadata.type === 'choice' && metadata.choices) {
+            if (!metadata.choices.includes(String(value))) {
+                return { valid: false, error: `Must be one of: ${metadata.choices.join(', ')}` };
+            }
+        }
+        // Custom validation
+        if (metadata.validation) {
+            const result = metadata.validation(String(value));
+            if (result !== true) {
+                return { valid: false, error: result };
+            }
+        }
+        return { valid: true };
+    }
+    /**
+     * Get default mentorship configuration
+     */
+    getDefaultConfig() {
+        return {
+            enabled: DEFAULT_SETTINGS.MENTORSHIP_ENABLED === 'true',
+            triggerOnError: DEFAULT_SETTINGS.MENTORSHIP_TRIGGER_ON_ERROR === 'true',
+            errorThreshold: DEFAULT_SETTINGS.MENTORSHIP_ERROR_THRESHOLD,
+            keywordsEnabled: DEFAULT_SETTINGS.MENTORSHIP_KEYWORDS_ENABLED === 'true',
+            customKeywords: DEFAULT_SETTINGS.MENTORSHIP_CUSTOM_KEYWORDS,
+            helperModel: DEFAULT_SETTINGS.MENTORSHIP_HELPER_MODEL,
+            turnBasedEnabled: DEFAULT_SETTINGS.MENTORSHIP_TURN_BASED_ENABLED === 'true',
+            turnInterval: parseInt(DEFAULT_SETTINGS.MENTORSHIP_TURN_INTERVAL),
+            interleavedThinking: DEFAULT_SETTINGS.MENTORSHIP_INTERLEAVED_THINKING === 'true',
+            patternDetection: DEFAULT_SETTINGS.MENTORSHIP_PATTERN_DETECTION === 'true',
+            patternThreshold: parseInt(DEFAULT_SETTINGS.MENTORSHIP_PATTERN_THRESHOLD)
+        };
+    }
+    /**
+     * Reset mentorship configuration to defaults
+     */
+    async resetToDefaults() {
+        await this.setConfig(this.getDefaultConfig());
+    }
+    /**
+     * Reload configuration from file
+     */
+    reload() {
+        this.loader.reload();
+    }
+    /**
+     * Quick enable mentorship with sensible defaults
+     */
+    async quickEnable() {
+        await this.setConfig({
+            enabled: true,
+            triggerOnError: true,
+            errorThreshold: 'medium',
+            patternDetection: true
+        });
+    }
+    /**
+     * Quick disable mentorship
+     */
+    async quickDisable() {
+        await this.setConfig({ enabled: false });
+    }
+    /**
+     * Get a summary of current configuration for display
+     */
+    getSummary() {
+        const config = this.getConfig();
+        const triggers = [];
+        if (config.triggerOnError) {
+            triggers.push(`Errors (${config.errorThreshold}+)`);
+        }
+        if (config.keywordsEnabled) {
+            triggers.push('Keywords');
+        }
+        if (config.turnBasedEnabled) {
+            triggers.push(`Every ${config.turnInterval} turns`);
+        }
+        if (config.patternDetection) {
+            triggers.push(`Pattern (${config.patternThreshold}+ similar)`);
+        }
+        return {
+            status: config.enabled ? 'enabled' : 'disabled',
+            triggers: triggers.length > 0 ? triggers : ['None configured'],
+            helperModel: config.helperModel
+        };
+    }
+}
+//# sourceMappingURL=MentorshipConfigService.js.map

package/dist/config/MentorshipConfigService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentorshipConfigService.js","sourceRoot":"","sources":["../../src/config/MentorshipConfigService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAwB,MAAM,qBAAqB,CAAC;AAqBhG;;GAEG;AACH,MAAM,cAAc,GAA2C;IAC7D,OAAO,EAAE,oBAAoB;IAC7B,cAAc,EAAE,6BAA6B;IAC7C,cAAc,EAAE,4BAA4B;IAC5C,eAAe,EAAE,6BAA6B;IAC9C,cAAc,EAAE,4BAA4B;IAC5C,WAAW,EAAE,yBAAyB;IACtC,gBAAgB,EAAE,+BAA+B;IACjD,YAAY,EAAE,0BAA0B;IACxC,mBAAmB,EAAE,iCAAiC;IACtD,gBAAgB,EAAE,8BAA8B;IAChD,gBAAgB,EAAE,8BAA8B;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,GAA2C,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;KACvF,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE;IACnC,GAAG,CAAC,MAAM,CAAC,GAAG,SAAmC,CAAC;IAClD,OAAO,GAAG,CAAC;AACb,CAAC,EAAE,EAA4C,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,MAAM,CAAiB;IACvB,MAAM,CAAiB;IAE/B,YAAY,cAAsB,OAAO,CAAC,GAAG,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,SAAS;QACP,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAEzC,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,kBAAkB,KAAK,MAAM;YAC1C,cAAc,EAAE,GAAG,CAAC,2BAA2B,KAAK,MAAM;YAC1D,cAAc,EAAE,GAAG,CAAC,0BAAuD;YAC3E,eAAe,EAAE,GAAG,CAAC,2BAA2B,KAAK,MAAM;YAC3D,cAAc,EAAE,GAAG,CAAC,0BAA0B;YAC9C,WAAW,EAAE,GAAG,CAAC,uBAAuB;YACxC,gBAAgB,EAAE,GAAG,CAAC,6BAA6B,KAAK,MAAM;YAC9D,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,EAAE;YAC1D,mBAAmB,EAAE,GAAG,CAAC,+BAA+B,KAAK,MAAM;YACnE,gBAAgB,EAAE,GAAG,CAAC,4BAA4B,KAAK,MAAM;YAC7D,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,4BAA4B,CAAC,IAAI,CAAC;SAClE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,MAAiC;QAC/C,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,cAAc,CAAC,GAA6B,CAAC,CAAC;YAC7D,IAAI,MAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAClC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/B,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC7C,CAAC;qBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACrC,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACrC,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAc,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAmC,GAAM;QAC/C,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAmC,GAAM,EAAE,KAA0B;QACjF,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAA+B,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;QAEtF,4BAA4B;QAC5B,MAAM,QAAQ,GAAkB;YAC9B;gBACE,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,GAAG;gBACT,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACxD,CAAC,CAAC,GAAG,KAAK,oBAAoB,IAAI,CAAC,CAAC,GAAG,KAAK,yBAAyB,CACtE,CAAC;aACH;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,gBAAgB;gBACvB,WAAW,EAAE,qCAAqC;gBAClD,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACxD,CAAC,CAAC,GAAG,KAAK,6BAA6B;oBACvC,CAAC,CAAC,GAAG,KAAK,4BAA4B;oBACtC,CAAC,CAAC,GAAG,KAAK,8BAA8B;oBACxC,CAAC,CAAC,GAAG,KAAK,8BAA8B,CACzC,CAAC;aACH;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,kBAAkB;gBACzB,WAAW,EAAE,iCAAiC;gBAC9C,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACxD,CAAC,CAAC,GAAG,KAAK,6BAA6B;oBACvC,CAAC,CAAC,GAAG,KAAK,4BAA4B,CACvC,CAAC;aACH;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,iBAAiB;gBACxB,WAAW,EAAE,iCAAiC;gBAC9C,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACxD,CAAC,CAAC,GAAG,KAAK,+BAA+B;oBACzC,CAAC,CAAC,GAAG,KAAK,0BAA0B,CACrC,CAAC;aACH;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,UAAU;gBACjB,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACxD,CAAC,CAAC,GAAG,KAAK,iCAAiC,CAC5C,CAAC;aACH;SACF,CAAC;QAEF,OAAO;YACL,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,0BAA0B;YACjC,WAAW,EAAE,+CAA+C;YAC5D,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YAClD,OAAO,EAAE,qBAAqB,EAAE;YAChC,MAAM,EAAE,+EAA+E;SACxF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,QAA2B;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACtB,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE/D,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;gBACf,KAAK,SAAS;oBACZ,OAAO;wBACL,IAAI,EAAE,QAAiB;wBACvB,GAAG,EAAE,CAAC,CAAC,GAAG;wBACV,KAAK,EAAE,CAAC,CAAC,WAAW;wBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,KAAK,EAAE,YAAY,KAAK,IAAI;wBAC5B,UAAU,EAAE,IAAI;qBACjB,CAAC;gBAEJ,KAAK,QAAQ;oBACX,OAAO;wBACL,IAAI,EAAE,QAAiB;wBACvB,GAAG,EAAE,CAAC,CAAC,GAAG;wBACV,KAAK,EAAE,CAAC,CAAC,WAAW;wBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,KAAK,EAAE,YAAsB,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE;wBAChD,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BACnC,KAAK,EAAE,CAAC;4BACR,KAAK,EAAE,CAAC;yBACT,CAAC,CAAC;wBACH,UAAU,EAAE,IAAI;qBACjB,CAAC;gBAEJ,KAAK,QAAQ;oBACX,OAAO;wBACL,IAAI,EAAE,QAAiB;wBACvB,GAAG,EAAE,CAAC,CAAC,GAAG;wBACV,KAAK,EAAE,CAAC,CAAC,WAAW;wBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,KAAK,EAAE,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC;wBACnF,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBACjD,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;wBACnD,UAAU,EAAE,KAAK;qBAClB,CAAC;gBAEJ,KAAK,QAAQ;oBACX,OAAO;wBACL,IAAI,EAAE,MAAe;wBACrB,GAAG,EAAE,CAAC,CAAC,GAAG;wBACV,KAAK,EAAE,CAAC,CAAC,WAAW;wBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,KAAK,EAAE,YAAsB,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE;wBAChD,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,UAAU,EAAE,KAAK;qBAClB,CAAC;gBAEJ;oBACE,OAAO;wBACL,IAAI,EAAE,MAAe;wBACrB,GAAG,EAAE,CAAC,CAAC,GAAG;wBACV,KAAK,EAAE,CAAC,CAAC,WAAW;wBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;qBAC/C,CAAC;YACN,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,GAAW,EAAE,KAAc;QACvC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAE5D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,kBAAkB;QAClB,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QAC1D,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;YACrD,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO;YACL,OAAO,EAAE,gBAAgB,CAAC,kBAAkB,KAAK,MAAM;YACvD,cAAc,EAAE,gBAAgB,CAAC,2BAA2B,KAAK,MAAM;YACvE,cAAc,EAAE,gBAAgB,CAAC,0BAAuD;YACxF,eAAe,EAAE,gBAAgB,CAAC,2BAA2B,KAAK,MAAM;YACxE,cAAc,EAAE,gBAAgB,CAAC,0BAA0B;YAC3D,WAAW,EAAE,gBAAgB,CAAC,uBAAuB;YACrD,gBAAgB,EAAE,gBAAgB,CAAC,6BAA6B,KAAK,MAAM;YAC3E,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,wBAAwB,CAAC;YACjE,mBAAmB,EAAE,gBAAgB,CAAC,+BAA+B,KAAK,MAAM;YAChF,gBAAgB,EAAE,gBAAgB,CAAC,4BAA4B,KAAK,MAAM;YAC1E,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,4BAA4B,CAAC;SAC1E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,SAAS,CAAC;YACnB,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,IAAI;YACpB,cAAc,EAAE,QAAQ;YACxB,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,UAAU;QAKR,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,YAAY,QAAQ,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,gBAAgB,YAAY,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;YAC/C,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;YAC9D,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;IACJ,CAAC;CACF"}

package/dist/config/RuntimeConfigRegistry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * RuntimeConfigRegistry
+ *
+ * Single source of truth for which settings can be hot-applied at runtime
+ * and the mapping from env var name to orchestrator config update.
+ *
+ * Three tiers:
+ *  - 'config': needs orchestrator.updateRuntimeConfig() — stored in this.config
+ *  - 'env': just process.env mutation is enough — read fresh each turn/request
+ *  - undefined: restart required — baked into objects at startup
+ */
+export type ConfigUpdateMapper = (value: string) => Record<string, unknown>;
+export interface RuntimeConfigEntry {
+    tier: 'config' | 'env';
+    mapper?: ConfigUpdateMapper;
+}
+export declare function getRuntimeConfigEntry(key: string): RuntimeConfigEntry | undefined;
+export declare function isLiveToggleable(key: string): boolean;
+export declare function getLiveLabel(key: string): '(live)' | '(restart required)';
+//# sourceMappingURL=RuntimeConfigRegistry.d.ts.map

package/dist/config/RuntimeConfigRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeConfigRegistry.d.ts","sourceRoot":"","sources":["../../src/config/RuntimeConfigRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AA0CD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEjF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,oBAAoB,CAEzE"}

package/dist/config/RuntimeConfigRegistry.js

@@ -0,0 +1,57 @@
+/**
+ * RuntimeConfigRegistry
+ *
+ * Single source of truth for which settings can be hot-applied at runtime
+ * and the mapping from env var name to orchestrator config update.
+ *
+ * Three tiers:
+ *  - 'config': needs orchestrator.updateRuntimeConfig() — stored in this.config
+ *  - 'env': just process.env mutation is enough — read fresh each turn/request
+ *  - undefined: restart required — baked into objects at startup
+ */
+const CONFIG_ENTRIES = {
+    // Config-stored: need updateRuntimeConfig() call
+    DEBUG: { tier: 'config', mapper: (v) => ({ debug: v === 'true' }) },
+    MENTORSHIP_ENABLED: { tier: 'config', mapper: (v) => ({ reactiveMentorship: { enabled: v === 'true' } }) },
+    MAX_TOOL_ITERATIONS: { tier: 'config', mapper: (v) => ({ loopControl: { maxToolIterations: parseInt(v, 10) } }) },
+    MAX_CONSECUTIVE_ERRORS: { tier: 'config', mapper: (v) => ({ loopControl: { maxConsecutiveErrors: parseInt(v, 10) } }) },
+    TOOL_TIMEOUT_MS: { tier: 'config', mapper: (v) => ({ loopControl: { toolTimeoutMs: parseInt(v, 10) } }) },
+    MAX_LOOP_REPETITIONS: { tier: 'config', mapper: (v) => ({ loopControl: { maxLoopRepetitions: parseInt(v, 10) } }) },
+    MODEL_ROUTER_ENABLED: { tier: 'config', mapper: (v) => ({ modelRouter: { enabled: v === 'true' } }) },
+    MODEL_ROUTER_STRATEGY: { tier: 'config', mapper: (v) => ({ modelRouter: { strategy: v } }) },
+    MODEL_ROUTER_RECORD: { tier: 'config', mapper: (v) => ({ modelRouter: { autoRecord: v === 'true' } }) },
+    // Env-read per-turn/request: process.env mutation is sufficient
+    ENABLE_SERVER_SIDE_TOOLS: { tier: 'env' },
+    ANTHROPIC_PROMPT_CACHING: { tier: 'env' },
+    TURN_SUMMARY_PREDICTION: { tier: 'env' },
+    CORTEX_ENDTURN_GATE: { tier: 'env' },
+    XAI_API_MODE: { tier: 'env' },
+    OPENAI_API_MODE: { tier: 'env' },
+    ENABLE_PTC: { tier: 'env' },
+    ENABLE_LOCAL_CODE_EXECUTION: { tier: 'env' },
+    ENABLE_DEFERRED_TOOL_LOADING: { tier: 'env' },
+    USE_EMOJI: { tier: 'env' },
+    WEB_TOOLS_MODEL: { tier: 'env' },
+    TOOL_BUDGET_SOFT: { tier: 'env' },
+    AGENT_TMUX_MONITOR: { tier: 'env' },
+    SYSTEM_MESSAGE_DOC_MAX_BYTES: { tier: 'env' },
+    // Training / Decision Store
+    CORTEX_RECORD_DECISIONS: { tier: 'env' },
+    CORTEX_LOOKUP_PRIOR_DECISIONS: { tier: 'env' },
+    CORTEX_DECISIONS_MAX_BYTES: { tier: 'env' },
+    // Runtime
+    YOLO: { tier: 'env' },
+    DEBUG_PAYLOAD: { tier: 'env' },
+    DEBUG_THINKING: { tier: 'env' },
+    AUTO_RESUME: { tier: 'env' },
+};
+export function getRuntimeConfigEntry(key) {
+    return CONFIG_ENTRIES[key];
+}
+export function isLiveToggleable(key) {
+    return key in CONFIG_ENTRIES;
+}
+export function getLiveLabel(key) {
+    return isLiveToggleable(key) ? '(live)' : '(restart required)';
+}
+//# sourceMappingURL=RuntimeConfigRegistry.js.map

package/dist/config/RuntimeConfigRegistry.js.map

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

package/dist/config/SettingsLoader.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Settings Loader
+ *
+ * Loads and writes configuration to .env file and creates OrchestratorConfig.
+ * Supports both reading and writing settings while preserving comments and formatting.
+ */
+import type { OrchestratorConfig } from '../orchestrator/CortexOrchestrator.js';
+import type { EnvironmentVariables } from './SettingsSchema.js';
+/**
+ * Result of a write operation
+ */
+export interface WriteResult {
+    success: boolean;
+    error?: string;
+    previousValue?: string;
+    newValue: string;
+}
+/**
+ * Parse .env file content into key-value pairs
+ */
+export declare function parseEnvFile(content: string): EnvironmentVariables;
+/**
+ * Load .env file from project root
+ */
+export declare function loadEnvFile(projectPath?: string): EnvironmentVariables;
+/**
+ * Update a single setting in the .env file while preserving comments and formatting
+ */
+export declare function writeEnvSetting(projectPath: string, key: keyof EnvironmentVariables, value: string): WriteResult;
+/**
+ * Update multiple settings in the .env file
+ */
+export declare function writeEnvSettings(projectPath: string, settings: Partial<EnvironmentVariables>): Record<string, WriteResult>;
+/**
+ * Get Google/Gemini API key with proper fallback
+ * Priority: GEMINI_API_KEY (recommended by Google) -> GOOGLE_API_KEY (legacy)
+ *
+ * @returns The API key to use for Google/Gemini models
+ */
+export declare function getGoogleApiKey(): string;
+/**
+ * Merge environment variables with defaults
+ */
+export declare function mergeWithDefaults(env: EnvironmentVariables): Required<EnvironmentVariables>;
+/**
+ * Convert environment variables to OrchestratorConfig
+ */
+export declare function envToOrchestratorConfig(env: Required<EnvironmentVariables>): OrchestratorConfig;
+/**
+ * Load OrchestratorConfig from .env file
+ */
+export declare function loadOrchestratorConfig(projectPath?: string): OrchestratorConfig;
+/**
+ * Settings Loader Class
+ */
+export declare class SettingsLoader {
+    private projectPath;
+    private env;
+    constructor(projectPath?: string);
+    /**
+     * Get full environment variables
+     */
+    getEnvironment(): Required<EnvironmentVariables>;
+    /**
+     * Get specific environment variable
+     */
+    get<K extends keyof EnvironmentVariables>(key: K): string;
+    /**
+     * Get OrchestratorConfig
+     */
+    getOrchestratorConfig(): OrchestratorConfig;
+    /**
+     * Check if API key is configured
+     */
+    hasApiKey(provider: 'anthropic' | 'openai' | 'google' | 'xai' | 'deepseek'): boolean;
+    /**
+     * Get Google API key with proper fallback
+     * Priority: GEMINI_API_KEY (recommended by Google) -> GOOGLE_API_KEY (legacy)
+     */
+    getGoogleApiKey(): string;
+    /**
+     * Get configured API providers
+     */
+    getConfiguredProviders(): string[];
+    /**
+     * Reload configuration from file
+     */
+    reload(): void;
+    /**
+     * Set a single environment variable and persist to .env file
+     */
+    set<K extends keyof EnvironmentVariables>(key: K, value: string): WriteResult;
+    /**
+     * Set multiple environment variables and persist to .env file
+     */
+    setMultiple(settings: Partial<EnvironmentVariables>): Record<string, WriteResult>;
+    /**
+     * Reset a setting to its default value
+     */
+    resetToDefault<K extends keyof EnvironmentVariables>(key: K): WriteResult;
+    /**
+     * Reset all settings to defaults
+     */
+    resetAllToDefaults(): Record<string, WriteResult>;
+    /**
+     * Get configuration summary for display
+     */
+    getSummary(): {
+        providers: string[];
+        defaultModel: string;
+        helperModel: string;
+        mentorshipEnabled: boolean;
+        debugEnabled: boolean;
+        mentorship?: {
+            triggerOnError: boolean;
+            errorThreshold: string;
+            keywordsEnabled: boolean;
+            helperModel: string;
+            turnBasedEnabled: boolean;
+            turnInterval: number;
+            interleavedThinking: boolean;
+            patternDetection: boolean;
+            patternThreshold: number;
+            activeDiscovery: boolean;
+        };
+    };
+}
+//# sourceMappingURL=SettingsLoader.d.ts.map

package/dist/config/SettingsLoader.d.ts.map

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