@axplusb/kepler 0.0.1 → 1.0.0

package/src/config/env.mjs

@@ -0,0 +1,263 @@
+/**
+ * Environment Variables — support for Claude Code env vars.
+ *
+ * Reads and normalizes the ~50 most important environment variables
+ * that control Claude Code behavior.
+ */
+
+/**
+ * All supported environment variables with defaults and descriptions.
+ */
+export const ENV_SCHEMA = {
+    // API Configuration
+    ANTHROPIC_API_KEY: { type: 'string', description: 'Anthropic API key' },
+    ANTHROPIC_BASE_URL: { type: 'string', default: 'https://api.anthropic.com', description: 'Anthropic API base URL' },
+    ANTHROPIC_MODEL: { type: 'string', description: 'Override default model' },
+    OPENAI_API_KEY: { type: 'string', description: 'OpenAI API key for compatible models' },
+    OPENAI_BASE_URL: { type: 'string', default: 'https://api.openai.com/v1', description: 'OpenAI-compatible base URL' },
+    GOOGLE_API_KEY: { type: 'string', description: 'Google AI API key' },
+    GEMINI_API_KEY: { type: 'string', description: 'Alias for GOOGLE_API_KEY' },
+
+    // Model Configuration
+    CLAUDE_CODE_MAX_OUTPUT_TOKENS: { type: 'number', default: 16384, description: 'Max output tokens' },
+    CLAUDE_CODE_SUBAGENT_MODEL: { type: 'string', description: 'Model for subagents' },
+    CLAUDE_CODE_EFFORT_LEVEL: { type: 'string', default: 'normal', description: 'Effort level (low/normal/high)' },
+
+    // Behavior Flags
+    CLAUDE_CODE_BRIEF: { type: 'boolean', default: false, description: 'Brief output mode' },
+    CLAUDE_CODE_DISABLE_CRON: { type: 'boolean', default: false, description: 'Disable cron tasks' },
+    CLAUDE_CODE_ENABLE_TASKS: { type: 'boolean', default: false, description: 'Enable task system' },
+    ORCA_STAGNATION_DETECTION: { type: 'boolean', default: false, description: 'Detect consecutive identical tool-call loops' },
+    ORCA_STAGNATION_THRESHOLD: { type: 'number', default: 3, description: 'Consecutive identical calls before warning' },
+    CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: { type: 'boolean', default: false, description: 'Enable agent teams' },
+    CLAUDE_CODE_DEBUG: { type: 'boolean', default: false, description: 'Debug mode' },
+    CLAUDE_CODE_DISABLE_TELEMETRY: { type: 'boolean', default: false, description: 'Disable telemetry' },
+
+    // Permission and Security
+    CLAUDE_CODE_PERMISSION_MODE: { type: 'string', default: 'default', description: 'Permission mode' },
+    CLAUDE_CODE_SANDBOX: { type: 'boolean', default: true, description: 'Enable sandbox' },
+
+    // Context and Memory
+    CLAUDE_CODE_MAX_CONTEXT_TOKENS: { type: 'number', default: 180000, description: 'Max context window tokens' },
+    CLAUDE_CODE_AUTO_COMPACT: { type: 'boolean', default: true, description: 'Auto-compact context' },
+
+    // UI and Display
+    SHOW_THINKING: { type: 'boolean', default: false, description: 'Show thinking blocks' },
+    SHOW_TOOL_RESULTS: { type: 'boolean', default: false, description: 'Show tool results in REPL' },
+    NO_COLOR: { type: 'boolean', default: false, description: 'Disable colored output' },
+    TERM: { type: 'string', description: 'Terminal type' },
+
+    // MCP
+    MCP_DEBUG: { type: 'boolean', default: false, description: 'MCP debug logging' },
+
+    // Remote
+    REMOTE_AGENT_URL: { type: 'string', description: 'Remote agent endpoint' },
+    REMOTE_AGENT_TOKEN: { type: 'string', description: 'Remote agent auth token' },
+
+    // Search
+    BRAVE_API_KEY: { type: 'string', description: 'Brave Search API key' },
+    SEARXNG_URL: { type: 'string', description: 'SearXNG instance URL' },
+
+    // Networking
+    HTTP_PROXY: { type: 'string', description: 'HTTP proxy URL' },
+    HTTPS_PROXY: { type: 'string', description: 'HTTPS proxy URL' },
+    NO_PROXY: { type: 'string', description: 'No-proxy list' },
+
+    // Agent Identity
+    AGENT_ID: { type: 'string', default: 'main', description: 'Agent identifier for teams' },
+
+    // Feature Flags
+    CLAUDE_CODE_THINKING: { type: 'boolean', default: false, description: 'Enable extended thinking' },
+    CLAUDE_CODE_THINKING_BUDGET: { type: 'number', default: 10000, description: 'Thinking token budget' },
+    CLAUDE_CODE_STREAMING: { type: 'boolean', default: true, description: 'Enable streaming' },
+
+    // Paths
+    CLAUDE_CONFIG_DIR: { type: 'string', description: 'Custom config directory' },
+    CLAUDE_CACHE_DIR: { type: 'string', description: 'Custom cache directory' },
+
+    // Extended: OAuth & Auth
+    CLAUDE_OAUTH_CLIENT_ID: { type: 'string', description: 'OAuth client ID' },
+    CLAUDE_OAUTH_REDIRECT_URI: { type: 'string', default: 'http://localhost:9876/callback', description: 'OAuth redirect URI' },
+    ANTHROPIC_AUTH_TOKEN: { type: 'string', description: 'Anthropic auth token (OAuth)' },
+
+    // Extended: Sandbox & Security
+    CLAUDE_CODE_SANDBOX_PLATFORM: { type: 'string', description: 'Override sandbox platform (linux/darwin)' },
+    CLAUDE_CODE_INJECTION_CHECK: { type: 'boolean', default: true, description: 'Enable command injection checks' },
+    CLAUDE_CODE_PATH_CHECK: { type: 'boolean', default: true, description: 'Enable file path validation' },
+
+    // Extended: Rate Limiting
+    CLAUDE_CODE_MAX_RETRIES: { type: 'number', default: 5, description: 'Max API retries on 429/529' },
+    CLAUDE_CODE_RETRY_BASE_DELAY: { type: 'number', default: 1000, description: 'Base retry delay in ms' },
+    CLAUDE_CODE_RETRY_MAX_DELAY: { type: 'number', default: 60000, description: 'Max retry delay in ms' },
+
+    // Extended: Agent Teams
+    CLAUDE_CODE_TEAM_SIZE: { type: 'number', default: 5, description: 'Max team size for multi-agent' },
+    CLAUDE_CODE_TEAM_BROADCAST: { type: 'boolean', default: false, description: 'Broadcast messages to all teammates' },
+
+    // Extended: Providers
+    AWS_ACCESS_KEY_ID: { type: 'string', description: 'AWS access key for Bedrock' },
+    AWS_SECRET_ACCESS_KEY: { type: 'string', description: 'AWS secret key for Bedrock' },
+    AWS_REGION: { type: 'string', default: 'us-east-1', description: 'AWS region for Bedrock' },
+    GOOGLE_APPLICATION_CREDENTIALS: { type: 'string', description: 'GCP service account credentials path' },
+    VERTEX_PROJECT: { type: 'string', description: 'GCP project for Vertex AI' },
+    VERTEX_REGION: { type: 'string', default: 'us-central1', description: 'GCP region for Vertex AI' },
+
+    // Extended: Cron & Scheduling
+    CLAUDE_CODE_CRON_INTERVAL: { type: 'number', default: 60000, description: 'Cron check interval in ms' },
+    CLAUDE_CODE_SCHEDULED_TASKS_FILE: { type: 'string', description: 'Path to scheduled tasks JSON' },
+
+    // Extended: Plugins
+    CLAUDE_CODE_PLUGIN_DIR: { type: 'string', description: 'Custom plugin directory' },
+    CLAUDE_CODE_DISABLE_PLUGINS: { type: 'boolean', default: false, description: 'Disable all plugins' },
+
+    // Extended: Session
+    CLAUDE_CODE_SESSION_TTL: { type: 'number', default: 86400000, description: 'Session TTL in ms (default 24h)' },
+    CLAUDE_CODE_AUTO_SAVE: { type: 'boolean', default: true, description: 'Auto-save sessions' },
+
+    // Extended: Logging
+    CLAUDE_CODE_LOG_LEVEL: { type: 'string', default: 'info', description: 'Log level (debug/info/warn/error)' },
+    CLAUDE_CODE_LOG_FILE: { type: 'string', description: 'Log file path' },
+
+    // Extended: Hooks
+    CLAUDE_CODE_HOOK_TIMEOUT: { type: 'number', default: 10000, description: 'Hook execution timeout in ms' },
+    CLAUDE_CODE_HOOK_FAIL_OPEN: { type: 'boolean', default: true, description: 'Allow on hook failure' },
+
+    // Extended: Context
+    CLAUDE_CODE_COMPACT_THRESHOLD: { type: 'number', default: 0.8, description: 'Context compaction threshold (0-1)' },
+    CLAUDE_CODE_MAX_MESSAGES: { type: 'number', default: 200, description: 'Max messages in context' },
+
+    // Extended: Cache
+    CLAUDE_CODE_PROMPT_CACHE: { type: 'boolean', default: true, description: 'Enable prompt caching' },
+    CLAUDE_CODE_CACHE_TTL: { type: 'number', default: 300000, description: 'Cache TTL in ms (default 5min)' },
+
+    // Extended: Output
+    CLAUDE_CODE_MAX_LINES: { type: 'number', default: 200, description: 'Max output lines for tools' },
+    CLAUDE_CODE_TRUNCATE: { type: 'boolean', default: true, description: 'Truncate long outputs' },
+    CLAUDE_CODE_JSON_OUTPUT: { type: 'boolean', default: false, description: 'Output JSON instead of text' },
+
+    // Extended: Git
+    CLAUDE_CODE_GIT_ENABLED: { type: 'boolean', default: true, description: 'Enable git operations' },
+    CLAUDE_CODE_GIT_AUTO_COMMIT: { type: 'boolean', default: false, description: 'Auto-commit changes' },
+
+    // Extended: Editor
+    EDITOR: { type: 'string', description: 'Default text editor' },
+    VISUAL: { type: 'string', description: 'Default visual editor' },
+
+    // Extended: Language
+    LANG: { type: 'string', description: 'System locale' },
+    LC_ALL: { type: 'string', description: 'Locale override' },
+
+    // Extended: CI/CD
+    CI: { type: 'boolean', default: false, description: 'Running in CI environment' },
+    GITHUB_ACTIONS: { type: 'boolean', default: false, description: 'Running in GitHub Actions' },
+    GITLAB_CI: { type: 'boolean', default: false, description: 'Running in GitLab CI' },
+
+    // Extended: Container
+    CONTAINER: { type: 'boolean', default: false, description: 'Running in container' },
+    DOCKER: { type: 'boolean', default: false, description: 'Running in Docker' },
+    CODESPACE_NAME: { type: 'string', description: 'GitHub Codespace name' },
+
+    // Extended: Notification
+    CLAUDE_CODE_NOTIFY: { type: 'boolean', default: false, description: 'Enable desktop notifications' },
+    CLAUDE_CODE_WEBHOOK_URL: { type: 'string', description: 'Webhook URL for notifications' },
+
+    // Extended: Experimental
+    CLAUDE_CODE_EXPERIMENTAL_MCP: { type: 'boolean', default: false, description: 'Enable experimental MCP features' },
+    CLAUDE_CODE_EXPERIMENTAL_TOOLS: { type: 'boolean', default: false, description: 'Enable experimental tools' },
+    CLAUDE_CODE_EXPERIMENTAL_VISION: { type: 'boolean', default: false, description: 'Enable vision/image support' },
+    CLAUDE_CODE_EXPERIMENTAL_MEMORY: { type: 'boolean', default: false, description: 'Enable persistent memory' },
+
+    // Extended: Worktree
+    CLAUDE_CODE_WORKTREE_DIR: { type: 'string', description: 'Default worktree base directory' },
+    CLAUDE_CODE_AUTO_WORKTREE: { type: 'boolean', default: false, description: 'Auto-create worktrees for branches' },
+
+    // Extended: Notebook
+    CLAUDE_CODE_NOTEBOOK_KERNEL: { type: 'string', default: 'python3', description: 'Default Jupyter kernel' },
+
+    // Extended: LSP
+    CLAUDE_CODE_LSP_ENABLED: { type: 'boolean', default: false, description: 'Enable LSP integration' },
+    CLAUDE_CODE_LSP_PORT: { type: 'number', default: 0, description: 'LSP server port (0 = auto)' },
+
+    // Extended: Timeouts
+    CLAUDE_CODE_TOOL_TIMEOUT: { type: 'number', default: 120000, description: 'Tool execution timeout in ms' },
+    CLAUDE_CODE_API_TIMEOUT: { type: 'number', default: 300000, description: 'API call timeout in ms' },
+    CLAUDE_CODE_MCP_TIMEOUT: { type: 'number', default: 30000, description: 'MCP operation timeout in ms' },
+
+    // Extended: Permissions (additional)
+    CLAUDE_CODE_ALLOWED_TOOLS: { type: 'string', description: 'Comma-separated list of allowed tools' },
+    CLAUDE_CODE_DISALLOWED_TOOLS: { type: 'string', description: 'Comma-separated list of disallowed tools' },
+
+    // Extended: Telemetry (additional)
+    CLAUDE_CODE_TELEMETRY_ENDPOINT: { type: 'string', description: 'Custom telemetry endpoint URL' },
+    CLAUDE_CODE_SENTRY_DSN: { type: 'string', description: 'Sentry DSN for error reporting' },
+};
+
+/**
+ * Read and normalize all environment variables.
+ * @returns {object} normalized env config
+ */
+export function readEnv() {
+    const env = {};
+
+    for (const [key, schema] of Object.entries(ENV_SCHEMA)) {
+        const raw = process.env[key];
+        if (raw === undefined) {
+            if (schema.default !== undefined) {
+                env[key] = schema.default;
+            }
+            continue;
+        }
+
+        switch (schema.type) {
+            case 'boolean':
+                env[key] = raw === '1' || raw === 'true' || raw === 'yes';
+                break;
+            case 'number':
+                env[key] = parseInt(raw, 10);
+                if (isNaN(env[key])) env[key] = schema.default;
+                break;
+            default:
+                env[key] = raw;
+        }
+    }
+
+    return env;
+}
+
+/**
+ * Get a specific env var with type coercion.
+ * @param {string} key
+ * @param {*} [defaultValue]
+ */
+export function getEnv(key, defaultValue) {
+    const schema = ENV_SCHEMA[key];
+    const raw = process.env[key];
+
+    if (raw === undefined) return defaultValue ?? schema?.default;
+
+    if (schema?.type === 'boolean') return raw === '1' || raw === 'true';
+    if (schema?.type === 'number') {
+        const n = parseInt(raw, 10);
+        return isNaN(n) ? defaultValue : n;
+    }
+    return raw;
+}
+
+/**
+ * List all supported env vars with their current values.
+ */
+export function listEnvVars() {
+    const result = [];
+    for (const [key, schema] of Object.entries(ENV_SCHEMA)) {
+        const value = process.env[key];
+        result.push({
+            key,
+            type: schema.type,
+            value: value || undefined,
+            default: schema.default,
+            description: schema.description,
+            isSet: value !== undefined,
+        });
+    }
+    return result;
+}

package/src/config/settings.mjs

@@ -0,0 +1,132 @@
+/**
+ * Settings chain — user/project/local/managed (from decompiled source).
+ *
+ * Supports all 76 properties from Claude Code's settings schema.
+ * Five-layer hierarchy: user > project > local > managed > feature flags.
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+/**
+ * Full settings schema with defaults.
+ */
+export const SETTINGS_SCHEMA = {
+    permissions: {
+        defaultMode: 'default',
+        allowRules: [],
+        denyRules: [],
+        allowedTools: [],
+        deniedTools: [],
+        sandbox: true,
+        sandboxAllowPaths: [],
+    },
+    hooks: {
+        PreToolUse: [],
+        PostToolUse: [],
+        PreToolUseFailure: [],
+        PostToolUseFailure: [],
+        Notification: [],
+        Stop: [],
+        SessionStart: [],
+    },
+    model: 'claude-sonnet-4-6',
+    subagentModel: null,
+    fastModel: 'claude-haiku-4-5',
+    fastMode: false,
+    alwaysThinkingEnabled: false,
+    autoCompactEnabled: true,
+    fileCheckpointingEnabled: true,
+    promptSuggestionEnabled: true,
+    briefMode: false,
+    maxContextTokens: 180000,
+    maxOutputTokens: 16384,
+    maxTokens: 16384,
+    thinkingBudget: 10000,
+    compactThreshold: 0.8,
+    stream: true,
+    stagnationDetection: false,
+    stagnationThreshold: 3,
+    mcpServers: {},
+    theme: 'auto',
+    showThinking: false,
+    showToolResults: false,
+    showTokenUsage: true,
+    vimMode: false,
+    terminalBell: false,
+    telemetryEnabled: false,
+    debugMode: false,
+    enableTeams: false,
+    agentId: null,
+    cronEnabled: true,
+    featureFlags: {},
+};
+
+export async function loadSettings() {
+    const chain = [
+        path.join(os.homedir(), '.claude', 'settings.json'),
+        path.join(process.cwd(), '.claude', 'settings.json'),
+        path.join(process.cwd(), '.claude', 'settings.local.json'),
+    ];
+
+    let merged = deepClone(SETTINGS_SCHEMA);
+
+    for (const file of chain) {
+        try {
+            const data = JSON.parse(fs.readFileSync(file, 'utf-8'));
+            merged = deepMerge(merged, data);
+        } catch {
+            // File not found or invalid
+        }
+    }
+
+    applyEnvOverrides(merged);
+    return merged;
+}
+
+function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const [key, value] of Object.entries(source)) {
+        if (value && typeof value === 'object' && !Array.isArray(value) && typeof result[key] === 'object' && !Array.isArray(result[key])) {
+            result[key] = deepMerge(result[key] || {}, value);
+        } else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+
+function applyEnvOverrides(settings) {
+    if (process.env.ANTHROPIC_MODEL) settings.model = process.env.ANTHROPIC_MODEL;
+    if (process.env.CLAUDE_CODE_SUBAGENT_MODEL) settings.subagentModel = process.env.CLAUDE_CODE_SUBAGENT_MODEL;
+    if (process.env.CLAUDE_CODE_MAX_OUTPUT_TOKENS) {
+        const n = parseInt(process.env.CLAUDE_CODE_MAX_OUTPUT_TOKENS, 10);
+        if (!isNaN(n)) { settings.maxOutputTokens = n; settings.maxTokens = n; }
+    }
+    if (process.env.CLAUDE_CODE_MAX_CONTEXT_TOKENS) {
+        const n = parseInt(process.env.CLAUDE_CODE_MAX_CONTEXT_TOKENS, 10);
+        if (!isNaN(n)) settings.maxContextTokens = n;
+    }
+    if (process.env.CLAUDE_CODE_BRIEF === '1') settings.briefMode = true;
+    if (process.env.CLAUDE_CODE_DEBUG === '1') settings.debugMode = true;
+    if (process.env.CLAUDE_CODE_PERMISSION_MODE) settings.permissions.defaultMode = process.env.CLAUDE_CODE_PERMISSION_MODE;
+    if (process.env.CLAUDE_CODE_STREAMING === '0') settings.stream = false;
+    if (process.env.CLAUDE_CODE_THINKING === '1') settings.alwaysThinkingEnabled = true;
+    if (process.env.CLAUDE_CODE_DISABLE_CRON === '1') settings.cronEnabled = false;
+    if (process.env.CLAUDE_CODE_ENABLE_TASKS === '1') settings.enableTeams = true;
+    const stagnationEnabled = process.env.ORCA_STAGNATION_DETECTION;
+    if (stagnationEnabled !== undefined) {
+        settings.stagnationDetection = ['1', 'true', 'yes', 'on'].includes(
+            stagnationEnabled.toLowerCase(),
+        );
+    }
+    const stagnationThreshold = process.env.ORCA_STAGNATION_THRESHOLD;
+    if (stagnationThreshold) {
+        const n = parseInt(stagnationThreshold, 10);
+        if (Number.isInteger(n) && n >= 2) settings.stagnationThreshold = n;
+    }
+}