@gaunt-sloth/core 2.0.0-alpha.3 → 2.0.0-alpha.4

package/dist/config.js

@@ -7,662 +7,20 @@
  * Refer to {@link DEFAULT_CONFIG} for default configuration.
  *
  * Some config params can be overriden from command line, see {@link CommandLineConfigOverrides}
- */
-import { PROJECT_GUIDELINES, PROJECT_REVIEW_INSTRUCTIONS, USER_PROJECT_CONFIG_JS, USER_PROJECT_CONFIG_JSON, USER_PROJECT_CONFIG_MJS, } from '#src/constants.js';
-import { StatusLevel } from '#src/core/types.js';
-import { displayDebug, displayError, displayInfo, displayWarning, setConsoleLevel, } from '#src/utils/consoleUtils.js';
-import { getGslothConfigReadPath, importExternalFile } from '#src/utils/fileUtils.js';
-import { getGlobalGslothConfigReadPath } from '#src/utils/globalConfigUtils.js';
-import { error, exit, isTTY, setUseColour } from '#src/utils/systemUtils.js';
-import { existsSync, readFileSync } from 'node:fs';
-/**
- * Default per-command shell timeout (ms) when {@link GthDevToolsConfig.shell}
- * does not specify one. ~120s suits typical build/test/git steps without
- * hanging the agent forever on a stuck command.
- */
-export const SHELL_DEFAULT_TIMEOUT_MS = 120_000;
-/**
- * Default byte budget for shell output captured into the ToolMessage returned to
- * the model (head + tail window). ~100KB keeps a noisy log from blowing the
- * context window; the full output is spilled to a temp file when this is exceeded.
- */
-export const SHELL_DEFAULT_MAX_OUTPUT_BYTES = 100_000;
-/**
- * Normalize the {@link GthDevToolsConfig.shell} opt-in (bare boolean or
- * `{ enabled }`) to a plain boolean. Centralized so the toolkit (tool emission)
- * and the deep agent (interrupt wiring) agree on what "shell enabled" means.
- *
- * EXT-12 — default-resolution: an EXPLICIT value always wins (a bare boolean, or the
- * object form's `enabled`), so `shell: false` / `{ enabled: false }` remains a hard
- * escape hatch that fully disables the tool. Only when `shell` is ABSENT/undefined does
- * the per-mode default apply: in `code` mode the shell tool is ON by default (still
- * gated — the per-command approval interrupt is wired separately and is NOT bypassed by
- * this), and OFF everywhere else (`exec`, `ask --write`, …) to preserve prior behaviour.
- * The default is `code`-mode only because `code` is the interactive agentic-coding surface
- * where a TTY can answer the approval prompt; the absent-config default never implies yolo.
  *
- * @param command The active command, so the absent-config default can be scoped to `code`.
- *   Omit (or pass a non-`code` command) to keep the historical OFF-by-default behaviour.
- */
-export function isShellToolEnabled(devTools, command) {
-    const shell = devTools?.shell;
-    if (typeof shell === 'boolean')
-        return shell;
-    if (shell && typeof shell === 'object')
-        return shell.enabled === true;
-    // Absent/undefined shell: ON by default for `code` mode (gated), OFF elsewhere.
-    return command === 'code';
-}
-/**
- * Resolve the per-command shell timeout (ms) from config, falling back to
- * {@link SHELL_DEFAULT_TIMEOUT_MS}. Only the object form can override it; a bare
- * `shell: true` uses the default. Non-positive / non-finite values are ignored.
- */
-export function getShellTimeoutMs(devTools) {
-    const shell = devTools?.shell;
-    if (shell && typeof shell === 'object' && typeof shell.timeout === 'number') {
-        if (Number.isFinite(shell.timeout) && shell.timeout > 0)
-            return shell.timeout;
-    }
-    return SHELL_DEFAULT_TIMEOUT_MS;
-}
-/**
- * Resolve the captured-output byte budget from config, falling back to
- * {@link SHELL_DEFAULT_MAX_OUTPUT_BYTES}. Only the object form can override it.
- * Non-positive / non-finite values are ignored.
- */
-export function getShellMaxOutputBytes(devTools) {
-    const shell = devTools?.shell;
-    if (shell && typeof shell === 'object' && typeof shell.maxOutputBytes === 'number') {
-        if (Number.isFinite(shell.maxOutputBytes) && shell.maxOutputBytes > 0) {
-            return shell.maxOutputBytes;
-        }
-    }
-    return SHELL_DEFAULT_MAX_OUTPUT_BYTES;
-}
-/**
- * Whether the EXT-9 Tier-2 scoped allow-list is active. Default `true`; only the object
- * form's `allowlist: false` disables it (a bare `shell: true` keeps it on). When off, the
- * runner prompts for every `run_shell_command` regardless of prior approvals.
- */
-export function isShellAllowlistEnabled(devTools) {
-    const shell = devTools?.shell;
-    if (shell && typeof shell === 'object' && shell.allowlist === false)
-        return false;
-    return true;
-}
-/**
- * Whether `always`-scoped approvals are persisted to the project allow-list file. Default
- * `true`; only the object form's `persistAllowlist: false` disables persistence (an
- * `always` decision then behaves as `session`).
- */
-export function isShellAllowlistPersisted(devTools) {
-    const shell = devTools?.shell;
-    if (shell && typeof shell === 'object' && shell.persistAllowlist === false)
-        return false;
-    return true;
-}
-/**
- * Whether the EXT-10 LLM-as-judge safety gate is enabled for the given dev-tools config.
- * Default OFF (only the object form's `judge` truthy enables it), mirroring
- * {@link isShellToolEnabled}. A bare `shell: true` keeps the judge OFF — it costs an LLM call
- * per command and must be opted into explicitly.
- */
-export function isShellJudgeEnabled(devTools) {
-    const shell = devTools?.shell;
-    if (!shell || typeof shell !== 'object')
-        return false;
-    const judge = shell.judge;
-    if (typeof judge === 'boolean')
-        return judge;
-    if (judge && typeof judge === 'object')
-        return judge.enabled === true;
-    return false;
-}
-/**
- * Resolve the EXT-10 judge gate settings from a dev-tools config, applying safe defaults
- * (auto-approve low, do NOT block high). `enabled` reflects {@link isShellJudgeEnabled}.
- */
-export function getShellJudgeSettings(devTools) {
-    const enabled = isShellJudgeEnabled(devTools);
-    const shell = devTools?.shell;
-    const judge = shell && typeof shell === 'object' && shell.judge && typeof shell.judge === 'object'
-        ? shell.judge
-        : undefined;
-    return {
-        enabled,
-        autoApproveLow: judge?.autoApproveLow ?? true,
-        blockHigh: judge?.blockHigh ?? false,
-        model: judge?.model,
-    };
-}
-/**
- * Resolve the {@link GthDevToolsConfig} that applies to the active command, mirroring the
- * per-command selection in `builtInToolsConfig.getDefaultTools` (which is what actually emits
- * the dev tools) and `GthDeepAgent.getEffectiveDevToolsConfig`: `exec` → `commands.exec`,
- * `ask --write` → `commands.ask`, `code` → `commands.code`; `undefined` elsewhere (the
- * toolkit is inert there). Shared in core so the runner's allow-list gate stays in lockstep
- * with where the shell tool is actually emitted.
- */
-export function getEffectiveDevToolsConfig(config, command) {
-    if (!config)
-        return undefined;
-    const askWrite = command === 'ask' && config.askWriteMode === true;
-    if (command === 'exec')
-        return config.commands?.exec?.devTools;
-    if (askWrite)
-        return config.commands?.ask?.devTools;
-    if (command === 'code')
-        return config.commands?.code?.devTools;
-    return undefined;
-}
-export const availableDefaultConfigs = [
-    'vertexai',
-    'anthropic',
-    'groq',
-    'deepseek',
-    'openai',
-    'google-genai',
-    'xai',
-    'openrouter',
-    'ollama',
-];
-/**
- * Default config
- */
-export const DEFAULT_CONFIG = {
-    contentSource: 'file',
-    requirementSource: 'file',
-    contentProvider: 'file',
-    requirementsProvider: 'file',
-    /**
-     * Path to project-specific guidelines.
-     * The default is `.gsloth.guidelines.md`; this config may be used to point Gaunt Sloth to a different file,
-     * for example, to AGENTS.md
-     */
-    projectGuidelines: PROJECT_GUIDELINES,
-    /**
-     * Whether to include the current date in the project review instructions or not.
-     */
-    includeCurrentDateAfterGuidelines: false,
-    projectReviewInstructions: PROJECT_REVIEW_INSTRUCTIONS,
-    filesystem: 'none',
-    debugLog: false,
-    consoleLevel: StatusLevel.INFO, // Default to INFO level, not debug
-    /**
-     * Default provider for both requirements and content is GitHub.
-     * It needs GitHub CLI (gh).
-     *
-     * `github` content provider uses `gh pr diff NN` internally. {@link src/providers/ghPrDiffProvider.ts!}
-     *
-     *
-     * `github` requirements provider `gh issue view NN` internally
-     */
-    commands: {
-        pr: {
-            contentSource: 'github',
-            requirementSource: 'github',
-            contentProvider: 'github',
-            requirementsProvider: 'github',
-            rating: {
-                enabled: true,
-                passThreshold: 6,
-                minRating: 0,
-                maxRating: 10,
-                errorOnReviewFail: true,
-            },
-        },
-        review: {
-            rating: {
-                enabled: true,
-                passThreshold: 6,
-                minRating: 0,
-                maxRating: 10,
-                errorOnReviewFail: true,
-            },
-        },
-        ask: {
-            filesystem: 'read',
-        },
-        chat: {
-            filesystem: 'read',
-        },
-        code: {
-            filesystem: 'all',
-        },
-        exec: {
-            filesystem: 'all',
-        },
-        api: {
-            filesystem: 'read',
-            port: 3000,
-            cors: {
-                allowOrigin: 'http://localhost:3000',
-                allowMethods: 'POST, GET, OPTIONS',
-                allowHeaders: 'Content-Type, Accept',
-            },
-        },
-    },
-    streamOutput: true,
-    writeOutputToFile: true,
-    writeBinaryOutputsToFile: true,
-    useColour: true,
-    streamSessionInferenceLog: true,
-    canInterruptInferenceWithEsc: true,
-    aiignore: {
-        enabled: true,
-        patterns: undefined,
-    },
-};
-/**
- * Needed DEFAULT_CONFIG to be plain const to be picked up by typedoc,
- * this cast here is just for typecheck.
- */
-// eslint-disable-next-line @typescript-eslint/no-unused-expressions
-DEFAULT_CONFIG;
-/**
- * Loads the global gsloth config (if present) from the global `~/.gsloth` folder.
- *
- * Precedence support: the returned raw config is intended to act as the BASE that the
- * project config (and CLI overrides) merge on top of, so any value here is the lowest
- * user-controlled layer (still above {@link DEFAULT_CONFIG}).
- *
- * Lookup order within the global folder, first match wins:
- *   `.gsloth.config.json` -> `.gsloth.config.js` -> `.gsloth.config.mjs`
- *
- * Absence of every variant is a no-op: returns `undefined` so behaviour is unchanged.
- *
- * NOTE: secrets (API keys) may live in this file; this function must never log its
- * contents. Only non-sensitive diagnostics (the resolved path / parse failure) are emitted.
- *
- * @returns The raw global config object, or `undefined` when no global config exists.
- */
-export async function loadGlobalRawConfig() {
-    // JSON first (the must-have format).
-    const jsonPath = getGlobalGslothConfigReadPath(USER_PROJECT_CONFIG_JSON);
-    if (existsSync(jsonPath)) {
-        try {
-            return JSON.parse(readFileSync(jsonPath, 'utf8'));
-        }
-        catch (e) {
-            displayDebug(e instanceof Error ? e : String(e));
-            displayWarning(`Failed to read global config from ${jsonPath}, ignoring it.`);
-            return undefined;
-        }
-    }
-    // Then JS / MJS variants (dynamic import of a `configure()` module).
-    for (const filename of [USER_PROJECT_CONFIG_JS, USER_PROJECT_CONFIG_MJS]) {
-        const modulePath = getGlobalGslothConfigReadPath(filename);
-        if (existsSync(modulePath)) {
-            try {
-                const imported = await importExternalFile(modulePath);
-                const configured = await imported.configure();
-                return configured;
-            }
-            catch (e) {
-                displayDebug(e instanceof Error ? e : String(e));
-                displayWarning(`Failed to read global config from ${modulePath}, ignoring it.`);
-                return undefined;
-            }
-        }
-    }
-    return undefined;
-}
-/**
- * Deep-merges a loaded global raw config UNDER the given project raw config, so the
- * project config wins on conflicting keys. When no global config exists this is a no-op
- * and the original project config is returned unchanged.
- */
-async function applyGlobalConfigBase(projectRawConfig) {
-    const globalRawConfig = await loadGlobalRawConfig();
-    if (!globalRawConfig) {
-        return projectRawConfig;
-    }
-    return deepMerge(globalRawConfig, projectRawConfig);
-}
-/**
- * Returns true when a project-level config file (json/js/mjs) exists for the given
- * overrides. Honours `customConfigPath` and the active identity profile so the check
- * matches exactly what {@link initConfig} would attempt to load.
- *
- * This is the project half of CFG-10's "is any config present?" detection; the global
- * half is {@link loadGlobalRawConfig} (used by {@link hasAnyConfig}).
- */
-export function hasProjectConfig(commandLineConfigOverrides) {
-    if (commandLineConfigOverrides.customConfigPath) {
-        return existsSync(commandLineConfigOverrides.customConfigPath);
-    }
-    return [USER_PROJECT_CONFIG_JSON, USER_PROJECT_CONFIG_JS, USER_PROJECT_CONFIG_MJS].some((filename) => existsSync(getGslothConfigReadPath(filename, commandLineConfigOverrides.identityProfile)));
-}
-/**
- * CFG-10 — true when ANY usable configuration is present, either a project config file
- * (json/js/mjs) or a standalone global config (`~/.gsloth/.gsloth.config.*`). When this
- * returns false the caller should run the first-run dialog instead of erroring.
- *
- * Reuses CFG-8's project + global detection so the two paths can never disagree.
- */
-export async function hasAnyConfig(commandLineConfigOverrides) {
-    if (hasProjectConfig(commandLineConfigOverrides)) {
-        return true;
-    }
-    return (await loadGlobalRawConfig()) !== undefined;
-}
-/**
- * Initialize configuration by loading from available config files
- * @returns The loaded GthConfig
- */
-export async function initConfig(commandLineConfigOverrides) {
-    if (commandLineConfigOverrides.customConfigPath &&
-        !existsSync(commandLineConfigOverrides.customConfigPath)) {
-        throw new Error(`Provided manual config "${commandLineConfigOverrides.customConfigPath}" does not exist`);
-    }
-    const jsonConfigPath = commandLineConfigOverrides.customConfigPath ??
-        getGslothConfigReadPath(USER_PROJECT_CONFIG_JSON, commandLineConfigOverrides.identityProfile);
-    // CFG-8 — when no project config file of any format exists, fall back to a standalone
-    // global config (loaded alone) before erroring. Project config still takes precedence:
-    // this branch only runs when there is no project file to apply the global config under.
-    if (!hasProjectConfig(commandLineConfigOverrides)) {
-        const globalRawConfig = await loadGlobalRawConfig();
-        if (globalRawConfig) {
-            if (globalRawConfig.llm &&
-                typeof globalRawConfig.llm === 'object' &&
-                'type' in globalRawConfig.llm) {
-                // Route the global config through the same path the project JSON uses.
-                return await tryJsonConfig(globalRawConfig, commandLineConfigOverrides);
-            }
-            displayError('Global configuration found but it is not in valid format. Should at least define llm.type');
-            exit(1);
-            // Unreachable past exit(1) in production; keeps TS happy and prevents test exit.
-            throw new Error('Unexpected error occurred.');
-        }
-    }
-    // Try loading the JSON config file first
-    if (jsonConfigPath.endsWith('.json') && existsSync(jsonConfigPath)) {
-        try {
-            // TODO makes sense to employ ZOD to validate config
-            const projectJsonConfig = JSON.parse(readFileSync(jsonConfigPath, 'utf8'));
-            // Apply global config as the base layer (project config wins on conflicts).
-            const jsonConfig = (await applyGlobalConfigBase(projectJsonConfig));
-            // If the config has an LLM with a type, create the appropriate LLM instance
-            if (jsonConfig.llm && typeof jsonConfig.llm === 'object' && 'type' in jsonConfig.llm) {
-                return await tryJsonConfig(jsonConfig, commandLineConfigOverrides);
-            }
-            else {
-                error(`${jsonConfigPath} is not in valid format. Should at least define llm.type`);
-                exit(1);
-                // noinspection ExceptionCaughtLocallyJS
-                // This throw is unreachable due to exit(1) above, but satisfies TS type analysis and prevents tests from exiting
-                // noinspection ExceptionCaughtLocallyJS
-                throw new Error('Unexpected error occurred.');
-            }
-        }
-        catch (e) {
-            displayDebug(e instanceof Error ? e : String(e));
-            displayError(`Failed to read config from ${USER_PROJECT_CONFIG_JSON}, will try other formats.`);
-            // Continue to try other formats
-            return await tryJsConfig(commandLineConfigOverrides);
-        }
-    }
-    else {
-        // JSON config not found, try JS
-        return tryJsConfig(commandLineConfigOverrides);
-    }
-}
-// Helper function to try loading JS config
-async function tryJsConfig(commandLineConfigOverrides) {
-    const jsConfigPath = commandLineConfigOverrides.customConfigPath ??
-        getGslothConfigReadPath(USER_PROJECT_CONFIG_JS, commandLineConfigOverrides.identityProfile);
-    if (jsConfigPath.endsWith('.js') && existsSync(jsConfigPath)) {
-        try {
-            const i = await importExternalFile(jsConfigPath);
-            const customConfig = await i.configure();
-            const mergedWithGlobal = await applyGlobalConfigBase(customConfig);
-            return await mergeConfig(mergedWithGlobal, commandLineConfigOverrides);
-        }
-        catch (e) {
-            displayDebug(e instanceof Error ? e : String(e));
-            displayError(`Failed to read config from ${USER_PROJECT_CONFIG_JS}, will try other formats.`);
-            // Continue to try other formats
-            return await tryMjsConfig(commandLineConfigOverrides);
-        }
-    }
-    else {
-        // JS config not found, try MJS
-        return await tryMjsConfig(commandLineConfigOverrides);
-    }
-}
-// Helper function to try loading MJS config
-async function tryMjsConfig(commandLineConfigOverrides) {
-    const mjsConfigPath = commandLineConfigOverrides.customConfigPath ??
-        getGslothConfigReadPath(USER_PROJECT_CONFIG_MJS, commandLineConfigOverrides.identityProfile);
-    if (mjsConfigPath.endsWith('.mjs') && existsSync(mjsConfigPath)) {
-        try {
-            const i = await importExternalFile(mjsConfigPath);
-            const customConfig = await i.configure();
-            const mergedWithGlobal = await applyGlobalConfigBase(customConfig);
-            return await mergeConfig(mergedWithGlobal, commandLineConfigOverrides);
-        }
-        catch (e) {
-            displayDebug(e instanceof Error ? e : String(e));
-            displayError(`Failed to read config from ${USER_PROJECT_CONFIG_MJS}.`);
-            displayError(`No valid configuration found. Please create a valid configuration file.`);
-            exit(1);
-        }
-    }
-    else {
-        // No config files found
-        displayError('No configuration file found. Please create one of: ' +
-            `${USER_PROJECT_CONFIG_JSON}, ${USER_PROJECT_CONFIG_JS}, or ${USER_PROJECT_CONFIG_MJS} ` +
-            'in your project directory.');
-        exit(1);
-    }
-    // This throw is unreachable due to exit(1) above, but satisfies TS type analysis and prevents tests from exiting
-    throw new Error('Unexpected error occurred.');
-}
-/**
- * Process JSON LLM config by creating the appropriate LLM instance
- * @param jsonConfig - The parsed JSON config
- * @param commandLineConfigOverrides - command line config overrides
- * @returns Promise<GthConfig>
- */
-export async function tryJsonConfig(jsonConfig, commandLineConfigOverrides) {
-    try {
-        if (jsonConfig.llm && typeof jsonConfig.llm === 'object') {
-            // Get the type of LLM (e.g. 'vertexai', 'anthropic') - this should exist
-            const llmType = jsonConfig.llm.type;
-            if (!llmType) {
-                displayError('LLM type not specified in config.');
-                exit(1);
-            }
-            // Get the configuration for the specific LLM type
-            const llmConfig = jsonConfig.llm;
-            if (commandLineConfigOverrides.verbose) {
-                // Necessary to avoid https://github.com/langchain-ai/langchainjs/issues/8705
-                llmConfig.verbose = commandLineConfigOverrides.verbose;
-            }
-            // Import the appropriate config module
-            const configModule = await import(`#src/providers/${llmType}.js`);
-            if (configModule.processJsonConfig) {
-                const llm = (await configModule.processJsonConfig(llmConfig));
-                const mergedConfig = mergeRawConfig(jsonConfig, llm, commandLineConfigOverrides);
-                if (configModule.postProcessJsonConfig) {
-                    return await configModule.postProcessJsonConfig(mergedConfig);
-                }
-                else {
-                    return await mergedConfig;
-                }
-            }
-            else {
-                displayWarning(`Config module for ${llmType} does not have processJsonConfig function.`);
-                exit(1);
-            }
-        }
-        else {
-            displayError('No LLM configuration found in config.');
-            exit(1);
-        }
-    }
-    catch (e) {
-        if (e instanceof Error && e.message.includes('Cannot find module')) {
-            displayError(`LLM type '${jsonConfig.llm.type}' not supported.`);
-        }
-        else {
-            displayError(`Error processing LLM config: ${e instanceof Error ? e.message : String(e)}`);
-        }
-        exit(1);
-    }
-    // This throw is unreachable due to exit(1) above, but satisfies TS type analysis and prevents tests from exiting
-    throw new Error('Unexpected error occurred.');
-}
-/**
- * Deep merge two objects, with source overriding target properties
- * @param target - The target object with default values
- * @param source - The source object with user overrides
- * @param maxDepth - Maximum recursion depth to prevent stack overflow (default: 4)
- */
-function deepMerge(target, source, maxDepth = 4) {
-    if (!source)
-        return target;
-    if (!target)
-        return source;
-    const result = { ...target };
-    // Return result without merging if depth is exceeded
-    if (maxDepth === 0)
-        return result;
-    for (const key in source) {
-        const sourceValue = source[key];
-        const targetValue = target[key];
-        if (sourceValue &&
-            typeof sourceValue === 'object' &&
-            !Array.isArray(sourceValue) &&
-            targetValue &&
-            typeof targetValue === 'object' &&
-            !Array.isArray(targetValue)) {
-            // Recursively merge nested objects
-            result[key] = deepMerge(targetValue, sourceValue, maxDepth - 1);
-        }
-        else if (sourceValue !== undefined) {
-            // Override with source value if it exists
-            result[key] = sourceValue;
-        }
-    }
-    return result;
-}
-/**
- * Merge config with default config
- */
-async function mergeConfig(partialConfig, commandLineConfigOverrides) {
-    const config = partialConfig;
-    // Migrate deprecated property names
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const raw = config;
-    if (raw.contentProvider && !raw.contentSource) {
-        displayWarning('Config property "contentProvider" is deprecated. Use "contentSource" instead.');
-        config.contentSource = raw.contentProvider;
-    }
-    if (raw.requirementsProvider && !raw.requirementSource) {
-        displayWarning('Config property "requirementsProvider" is deprecated. Use "requirementSource" instead.');
-        config.requirementSource = raw.requirementsProvider;
-    }
-    // Keep both old and new in sync
-    if (config.contentSource)
-        config.contentProvider = config.contentSource;
-    if (config.requirementSource)
-        config.requirementsProvider = config.requirementSource;
-    // Migrate command-level deprecated properties
-    if (config.commands) {
-        for (const cmdName of ['pr', 'review']) {
-            const cmd = config.commands[cmdName];
-            if (cmd) {
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                const cmdRaw = cmd;
-                if (cmdRaw.contentProvider && !cmdRaw.contentSource) {
-                    cmd.contentSource = cmdRaw.contentProvider;
-                }
-                if (cmdRaw.requirementsProvider && !cmdRaw.requirementSource) {
-                    cmd.requirementSource = cmdRaw.requirementsProvider;
-                }
-                if (cmd.contentSource)
-                    cmd.contentProvider = cmd.contentSource;
-                if (cmd.requirementSource)
-                    cmd.requirementsProvider = cmd.requirementSource;
-            }
-        }
-    }
-    // Deep merge command configs while preserving defaults
-    // Type complexity from DEFAULT_CONFIG.commands 'as const' requires any cast for deep merge result
-    const mergedCommands = {
-        pr: deepMerge(DEFAULT_CONFIG.commands.pr, config?.commands?.pr), // eslint-disable-line @typescript-eslint/no-explicit-any
-        review: deepMerge(DEFAULT_CONFIG.commands.review, config?.commands?.review), // eslint-disable-line @typescript-eslint/no-explicit-any
-        code: deepMerge(DEFAULT_CONFIG.commands.code, config?.commands?.code), // eslint-disable-line @typescript-eslint/no-explicit-any
-        exec: deepMerge(DEFAULT_CONFIG.commands.exec, config?.commands?.exec), // eslint-disable-line @typescript-eslint/no-explicit-any
-        ask: deepMerge(DEFAULT_CONFIG.commands.ask, config?.commands?.ask), // eslint-disable-line @typescript-eslint/no-explicit-any
-        chat: deepMerge(DEFAULT_CONFIG.commands.chat, config?.commands?.chat), // eslint-disable-line @typescript-eslint/no-explicit-any
-        api: deepMerge(DEFAULT_CONFIG.commands.api, config?.commands?.api), // eslint-disable-line @typescript-eslint/no-explicit-any
-    };
-    const mergedConfig = {
-        ...DEFAULT_CONFIG,
-        ...config,
-        commands: mergedCommands,
-    };
-    if (commandLineConfigOverrides.identityProfile !== undefined) {
-        displayInfo(`Activating profile: ${commandLineConfigOverrides.identityProfile}`);
-        mergedConfig.identityProfile = commandLineConfigOverrides.identityProfile.trim();
-    }
-    if (commandLineConfigOverrides.verbose !== undefined) {
-        mergedConfig.llm.verbose = commandLineConfigOverrides.verbose;
-    }
-    if (commandLineConfigOverrides.writeOutputToFile !== undefined) {
-        mergedConfig.writeOutputToFile = commandLineConfigOverrides.writeOutputToFile;
-    }
-    // Set the useColour value in systemUtils
-    setUseColour(mergedConfig.useColour);
-    // Set console logging level
-    if (mergedConfig.consoleLevel !== undefined) {
-        const resolvedConsoleLevel = resolveConsoleLevel(mergedConfig.consoleLevel);
-        if (resolvedConsoleLevel !== undefined) {
-            mergedConfig.consoleLevel = resolvedConsoleLevel;
-            setConsoleLevel(resolvedConsoleLevel);
-        }
-        else {
-            displayWarning(`Invalid consoleLevel "${String(mergedConfig.consoleLevel)}", using default ${StatusLevel.INFO}.`);
-            mergedConfig.consoleLevel = StatusLevel.INFO;
-            setConsoleLevel(StatusLevel.INFO);
-        }
-    }
-    mergedConfig.canInterruptInferenceWithEsc = mergedConfig.canInterruptInferenceWithEsc && isTTY();
-    return mergedConfig;
-}
-const CONSOLE_LEVELS_BY_NAME = {
-    debug: StatusLevel.DEBUG,
-    info: StatusLevel.INFO,
-    display: StatusLevel.DISPLAY,
-    success: StatusLevel.SUCCESS,
-    warning: StatusLevel.WARNING,
-    error: StatusLevel.ERROR,
-    stream: StatusLevel.STREAM,
-};
-function resolveConsoleLevel(level) {
-    if (typeof level === 'number') {
-        return StatusLevel[level] !== undefined ? level : undefined;
-    }
-    if (typeof level === 'string') {
-        const normalized = level.trim().toLowerCase();
-        if (normalized in CONSOLE_LEVELS_BY_NAME) {
-            return CONSOLE_LEVELS_BY_NAME[normalized];
-        }
-        const enumValue = StatusLevel[level];
-        if (typeof enumValue === 'number') {
-            return enumValue;
-        }
-    }
-    return undefined;
-}
-/**
- * Merge raw with default config
- */
-async function mergeRawConfig(config, llm, commandLineConfigOverrides) {
-    const modelDisplayName = config.llm?.model;
-    return await mergeConfig({ ...config, llm, modelDisplayName }, commandLineConfigOverrides);
-}
+ * This module is the **public barrel** for the configuration system. The implementation
+ * is split into focused modules under `config/`:
+ * - `config/types.ts` — the configuration type surface.
+ * - `config/shell-policy.ts` — {@link GthDevToolsConfig} + the shell/dev-tools resolvers.
+ * - `config/defaults.ts` — {@link DEFAULT_CONFIG}.
+ * - `config/loader.ts` — discovery + the layered load/merge pipeline.
+ * - `config/schema.ts` — the Zod schema (single source of truth) + JSON-Schema generator.
+ *
+ * Every name that was previously exported from `config.ts` is re-exported here, so the
+ * public import path `@gaunt-sloth/core/config.js` (and `#src/config.js`) is unchanged.
+ */
+export * from '#src/config/types.js';
+export * from '#src/config/shell-policy.js';
+export * from '#src/config/defaults.js';
+export * from '#src/config/loader.js';
 //# sourceMappingURL=config.js.map