deeper-cli 1.0.0

package/src/cli/index.ts

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { DEEPER_VERSION } from '../core/constants.ts';
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    return startChat({});
+  }
+
+  const { values, positionals } = parseArgs({
+    args,
+    options: {
+      help: { type: 'boolean', short: 'h' },
+      version: { type: 'boolean', short: 'v' },
+      model: { type: 'string', short: 'm' },
+      'api-key': { type: 'string', short: 'k' },
+      verbose: { type: 'boolean' },
+      'auto-run': { type: 'string' },
+    },
+    allowPositionals: true,
+  });
+
+  if (values.help) {
+    showHelp();
+    return;
+  }
+
+  if (values.version) {
+    console.log(`DeeperCode v${DEEPER_VERSION}`);
+    return;
+  }
+
+  const command = positionals[0];
+  const commandArgs = positionals.slice(1);
+
+  const globalOpts = {
+    model: values.model || process.env.DEEPER_MODEL,
+    apiKey: values['api-key'] || process.env.DEEPSEEK_API_KEY,
+    verbose: values.verbose,
+  };
+
+  switch (command) {
+    case 'chat':
+    case 'repl': {
+      await startChat({
+        ...globalOpts,
+        autoRun: values['auto-run'],
+      });
+      break;
+    }
+
+    case 'run':
+    case 'exec': {
+      const task = commandArgs.join(' ');
+      if (!task) {
+        console.error('❌ 请提供任务描述');
+        console.error('   用法: deeper run "任务描述"');
+        process.exit(1);
+      }
+      const { run } = await import('./commands/run.ts');
+      await run(task, globalOpts);
+      break;
+    }
+
+    case 'config': {
+      const { configCommand } = await import('./commands/config.ts');
+      await configCommand(commandArgs);
+      break;
+    }
+
+    case 'skill':
+    case 'skills': {
+      const { skillCommand } = await import('./commands/skill.ts');
+      await skillCommand(commandArgs);
+      break;
+    }
+
+    case 'mcp': {
+      const { mcpCommand } = await import('./commands/mcp.ts');
+      await mcpCommand(commandArgs);
+      break;
+    }
+
+    case 'version': {
+      console.log(`DeeperCode v${DEEPER_VERSION}`);
+      break;
+    }
+
+    default: {
+      const task = positionals.join(' ').trim();
+      if (task) {
+        const { run } = await import('./commands/run.ts');
+        await run(task, globalOpts);
+      } else {
+        console.error(`未知命令: ${positionals[0] || ''}`);
+        console.error('使用 --help 查看帮助');
+        process.exit(1);
+      }
+    }
+  }
+}
+
+async function startChat(opts: {
+  model?: string;
+  apiKey?: string;
+  verbose?: boolean;
+  autoRun?: string;
+}) {
+  const { chat } = await import('./commands/chat.js');
+  await chat(opts);
+}
+
+function showHelp() {
+  console.log(`
+██████╗ ███████╗███████╗██████╗ ███████╗██████╗
+██╔══██╗██╔════╝██╔════╝██╔══██╗██╔════╝██╔══██╗
+██║  ██║█████╗  █████╗  ██████╔╝█████╗  ██████╔╝
+██║  ██║██╔══╝  ██╔══╝  ██╔═══╝ ██╔══╝  ██╔══██╗
+██████╔╝███████╗███████╗██║     ███████╗██║  ██║
+╚═════╝ ╚══════╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝
+██████╗ ██████╗ ██████╗ ███████╗
+██╔════╝██╔═══██╗██╔══██╗██╔════╝
+██║     ██║   ██║██║  ██║█████╗
+██║     ██║   ██║██║  ██║██╔══╝
+╚██████╗╚██████╔╝██████╔╝███████╗
+ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝
+
+DeeperCode v${DEEPER_VERSION} - 一句话生成完整项目的 AI Agentic CLI 工具
+
+用法:
+  deeper [options]                 启动交互式 REPL
+  deeper chat [options]            启动聊天模式
+  deeper run "任务描述" [options]   单次执行任务
+  deeper config <subcommand>       配置管理
+  deeper skill <subcommand>        Skill 管理
+  deeper mcp <subcommand>          MCP 管理
+
+选项:
+  -h, --help            显示帮助信息
+  -v, --version         显示版本号
+  -m, --model <model>   指定模型 (默认: deepseek-v4-pro, 可选: v4-flash)
+  -k, --api-key <key>   指定 API Key
+  --verbose             详细输出模式
+  --auto-run <task>     自动运行任务后进入 REPL
+
+子命令:
+  deeper config list              列出配置
+  deeper config set <key> <value> 设置配置
+  deeper config get <key>         获取配置
+  deeper config reset             重置配置
+
+  deeper skill list               列出 Skills
+  deeper skill create <name>      创建 Skill
+
+  deeper mcp list                 列出 MCP 服务器
+  deeper mcp add <name> ...       添加 MCP 服务器
+  deeper mcp remove <name>        移除 MCP 服务器
+
+环境变量:
+  DEEPSEEK_API_KEY    DeepSeek API Key
+  DEEPER_HOME         DeeperCode 数据目录 (默认: ~/.deeper)
+  DEEPER_MODEL        默认模型名称
+
+内存:
+  如遇 OOM，使用 node --max-old-space-size=4096 $(which deeper) 启动
+  Windows: set NODE_OPTIONS=--max-old-space-size=4096 && deeper
+
+示例:
+  deeper                             启动交互式 REPL
+  deeper run "创建一个 React 应用"    单次执行
+  deeper --model deepseek-v4-pro -k sk-xxxx  指定模型和密钥
+  deeper --model deepseek-v4-flash             使用快速模型
+  deeper config set theme light      切换亮色主题
+
+使用 DeepSeek-V4-Pro 驱动 | 105+ 内置工具 | 强大的 Agent 系统
+`);
+}
+
+main().catch((err) => {
+  console.error('❌ 启动失败:', err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/src/core/bugscan.ts

@@ -0,0 +1,145 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { extname, basename } from 'node:path';
+
+const MAX_FILE_SIZE = 500_000;
+
+export interface BugReport {
+  file: string;
+  line?: number;
+  severity: 'error' | 'warning' | 'info';
+  message: string;
+  suggestion?: string;
+  category: string;
+}
+
+const LANG_CONFIGS: Record<string, { name: string; patterns: Array<{ re: RegExp; severity: BugReport['severity']; cat: string; msg: string; hint?: string }> }> = {
+  '.ts': { name: 'TypeScript', patterns: [
+    { re: /:\s*any\b/g, severity: 'warning', cat: '类型安全', msg: '使用了 `any` 类型，建议指定具体类型', hint: '将 `any` 替换为具体接口或类型' },
+    { re: /console\.(log|warn|error|debug)\(/g, severity: 'info', cat: '调试代码', msg: '生产代码中留有 console 调用', hint: '移除此调试语句或使用 logger' },
+    { re: /as\s+[A-Z]\w+/g, severity: 'warning', cat: '类型安全', msg: '使用 `as` 类型断言', hint: '优先使用类型守卫替代类型断言' },
+    { re: /@ts-ignore/g, severity: 'warning', cat: '类型安全', msg: '使用 @ts-ignore 忽略类型检查', hint: '修复类型错误而非忽略' },
+    { re: /setTimeout\([^,)]*\)/g, severity: 'info', cat: '可靠性', msg: 'setTimeout 缺少错误处理', hint: '考虑在回调中添加 try-catch' },
+  ]},
+  '.js': { name: 'JavaScript', patterns: [
+    { re: /console\.(log|warn|error|debug)\(/g, severity: 'info', cat: '调试代码', msg: '生产代码中留有 console 调用' },
+    { re: /var\s+/g, severity: 'warning', cat: '代码风格', msg: '使用了 `var`，建议使用 `const`/`let`' },
+    { re: /==(?!=)/g, severity: 'warning', cat: '逻辑错误', msg: '使用了 `==` 而非 `===`', hint: '使用 `===` 进行严格比较' },
+    { re: /eval\(/g, severity: 'error', cat: '安全', msg: '使用 eval() 存在安全风险', hint: '避免使用 eval' },
+    { re: /innerHTML\s*=/g, severity: 'warning', cat: '安全', msg: '直接修改 innerHTML 有 XSS 风险', hint: '使用 textContent 或安全 DOM 方法' },
+  ]},
+  '.py': { name: 'Python', patterns: [
+    { re: /except\s*:/g, severity: 'warning', cat: '错误处理', msg: '使用了裸 except 捕获所有异常' },
+    { re: /except\s+Exception\s*:/g, severity: 'info', cat: '错误处理', msg: '捕获范围过宽', hint: '捕获更具体的异常类型' },
+    { re: /:\s*print\(/g, severity: 'info', cat: '调试代码', msg: '生产代码中留有 print 调用' },
+    { re: /input\(/g, severity: 'info', cat: '安全', msg: '未校验用户输入' },
+    { re: /exec\(/g, severity: 'error', cat: '安全', msg: '使用 exec() 存在安全风险' },
+    { re: /import\s+\*/g, severity: 'info', cat: '代码风格', msg: '通配符导入，建议明确导入' },
+  ]},
+  '.json': { name: 'JSON', patterns: [
+  ]},
+  '.css': { name: 'CSS', patterns: [
+    { re: /!important/g, severity: 'warning', cat: 'CSS 反模式', msg: '使用 !important', hint: '通过提高选择器特异性替代' },
+    { re: /position:\s*absolute/g, severity: 'info', cat: '布局', msg: '大量 absolute 定位可能影响响应式' },
+  ]},
+  '.html': { name: 'HTML', patterns: [
+    { re: /<script[^>]*>/, severity: 'info', cat: '安全', msg: '内联 script 标签' },
+    { re: /on\w+\s*=/, severity: 'warning', cat: '安全', msg: '内联事件处理器 (onclick 等)', hint: '使用 addEventListener 替代' },
+  ]},
+  '.java': { name: 'Java', patterns: [
+    { re: /System\.out\.print/, severity: 'info', cat: '调试代码', msg: '留有 System.out 调用', hint: '使用日志框架替代' },
+    { re: /catch\s*\(\s*Exception\s+/g, severity: 'warning', cat: '错误处理', msg: '捕获范围过宽' },
+  ]},
+  '.go': { name: 'Go', patterns: [
+    { re: /_,\s*_\s*:=/g, severity: 'warning', cat: '错误处理', msg: '忽略了错误返回值', hint: '应处理返回的 error' },
+    { re: /panic\(/g, severity: 'warning', cat: '错误处理', msg: '使用 panic 而非 error 返回', hint: '优先使用 error 返回值' },
+  ]},
+  '.rs': { name: 'Rust', patterns: [
+    { re: /\.unwrap\(\)/g, severity: 'warning', cat: '错误处理', msg: '使用 unwrap() 可能导致 panic', hint: '使用 ? 或 match 处理错误' },
+    { re: /unsafe\s*\{/g, severity: 'warning', cat: '安全', msg: '使用了 unsafe 块' },
+  ]},
+};
+
+export function analyzeFile(filePath: string): BugReport[] {
+  if (!existsSync(filePath)) return [];
+  try { if (statSync(filePath).size > MAX_FILE_SIZE) return []; } catch { return []; }
+  const reports: BugReport[] = [];
+  const ext = extname(filePath).toLowerCase();
+  const config = LANG_CONFIGS[ext];
+  if (!config) return [];
+
+  try {
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+
+    for (const pattern of config.patterns) {
+      if (!pattern.msg) continue;
+      let match;
+      pattern.re.lastIndex = 0;
+      while ((match = pattern.re.exec(content)) !== null) {
+        if (!pattern.msg) continue;
+        const lineNum = content.slice(0, match.index).split('\n').length;
+        reports.push({
+          file: basename(filePath),
+          line: lineNum,
+          severity: pattern.severity,
+          message: pattern.msg,
+          suggestion: pattern.hint,
+          category: pattern.cat,
+        });
+      }
+    }
+
+    // 通用检查 (跨语言)
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const trimmed = line.trim();
+
+      // 超长行
+      if (trimmed.length > 200 && !trimmed.startsWith('//') && !trimmed.startsWith('#')) {
+        reports.push({
+          file: basename(filePath), line: i + 1, severity: 'info',
+          message: `行过长 (${trimmed.length} 字符)`, suggestion: '考虑拆分或格式化',
+          category: '代码风格',
+        });
+      }
+
+      // TODO/FIXME/HACK/BUG 标记
+      if (/\/\/\s*(TODO|FIXME|HACK|BUG|XXX)\b/i.test(trimmed) ||
+          /#\s*(TODO|FIXME|HACK|BUG|XXX)\b/i.test(trimmed)) {
+        const tag = trimmed.match(/(?:TODO|FIXME|HACK|BUG|XXX)/i)?.[0] || '';
+        reports.push({
+          file: basename(filePath), line: i + 1,
+          severity: tag === 'BUG' ? 'error' : tag === 'FIXME' ? 'warning' : 'info',
+          message: `标记为 ${tag}`, suggestion: '建议及时处理',
+          category: '代码标记',
+        });
+      }
+    }
+  } catch { return []; }
+
+  return reports;
+}
+
+export function summarizeBugs(reports: BugReport[]): string {
+  if (reports.length === 0) return '';
+  const errs = reports.filter(r => r.severity === 'error').length;
+  const warns = reports.filter(r => r.severity === 'warning').length;
+  const infos = reports.filter(r => r.severity === 'info').length;
+
+  let s = `[BugScan] 检查发现 ${reports.length} 个问题`;
+  if (errs > 0) s += ` · ${errs} ❌错误`;
+  if (warns > 0) s += ` · ${warns} ⚠警告`;
+  if (infos > 0) s += ` · ${infos} ℹ提示`;
+  s += '\n';
+
+  const top = reports.slice(0, 8);
+  for (const r of top) {
+    const sev = r.severity === 'error' ? '❌' : r.severity === 'warning' ? '⚠' : 'ℹ';
+    s += `${sev} ${r.file}:${r.line ?? '?'} [${r.category}] ${r.message}`;
+    if (r.suggestion) s += ` → ${r.suggestion}`;
+    s += '\n';
+  }
+
+  if (reports.length > 8) s += `... 还有 ${reports.length - 8} 个问题\n`;
+  return s;
+}

package/src/core/config.ts

@@ -0,0 +1,285 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import process from 'node:process';
+import { DEEPER_CONFIG_FILE, PROJECT_CONFIG_FILE, DEEPSEEK_DEFAULT_MODEL, DEEPSEEK_BASE_URL } from './constants.js';
+
+export interface MCPConfigEntry {
+  name: string;
+  command?: string;
+  args?: string[];
+  url?: string;
+  enabled: boolean;
+  autoConnect: boolean;
+}
+
+export interface SkillConfigEntry {
+  name: string;
+  path: string;
+  enabled: boolean;
+  autoLoad: boolean;
+}
+
+export interface DeeperConfig {
+  model: string;
+  apiKey: string;
+  baseUrl: string;
+  temperature: number;
+  maxTokens: number;
+  thinkEnabled: boolean;
+  thinkBudget: number;
+  thinkBudgetTokens: number;
+  logLevel: string;
+  maxRetries: number;
+  timeoutMs: number;
+  maxSubAgents: number;
+  maxRecursionDepth: number;
+  theme: 'dark' | 'light';
+  locale: string;
+  mcpServers: MCPConfigEntry[];
+  skills: SkillConfigEntry[];
+  [key: string]: unknown;
+}
+
+const DEFAULT_CONFIG: DeeperConfig = {
+  model: DEEPSEEK_DEFAULT_MODEL,
+  apiKey: process.env.DEEPSEEK_API_KEY || '',
+  baseUrl: DEEPSEEK_BASE_URL,
+  temperature: 0.7,
+  maxTokens: 8192,
+  thinkEnabled: true,
+  thinkBudget: 32000,
+  thinkBudgetTokens: 32000,
+  logLevel: 'info',
+  maxRetries: 3,
+  timeoutMs: 120000,
+  maxSubAgents: 5,
+  maxRecursionDepth: 2,
+  theme: 'dark',
+  locale: 'zh-CN',
+  mcpServers: [],
+  skills: [],
+};
+
+const PROJECT_CONFIG_PATH = join(process.cwd(), PROJECT_CONFIG_FILE);
+const USER_CONFIG_PATH = DEEPER_CONFIG_FILE;
+
+export class ConfigManager {
+  private defaults: DeeperConfig;
+  private userConfig: Partial<DeeperConfig>;
+  private projectConfig: Partial<DeeperConfig>;
+  private envOverrides: Partial<DeeperConfig>;
+  private cliOverrides: Partial<DeeperConfig>;
+
+  constructor() {
+    this.defaults = { ...DEFAULT_CONFIG };
+    this.userConfig = {};
+    this.projectConfig = {};
+    this.envOverrides = {};
+    this.cliOverrides = {};
+  }
+
+  load(): void {
+    this.userConfig = this.readJSONFile(USER_CONFIG_PATH);
+    this.projectConfig = this.readJSONFile(PROJECT_CONFIG_PATH);
+    this.envOverrides = this.readEnvOverrides();
+  }
+
+  save(scope: 'user' | 'project'): void {
+    const configPath = scope === 'user' ? USER_CONFIG_PATH : PROJECT_CONFIG_PATH;
+    const currentConfig = scope === 'user' ? this.userConfig : this.projectConfig;
+    const dir = dirname(configPath);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(configPath, JSON.stringify(currentConfig, null, 2), 'utf-8');
+  }
+
+  get<K extends keyof DeeperConfig>(key: K): DeeperConfig[K] {
+    if (key in this.cliOverrides) {
+      return this.cliOverrides[key] as DeeperConfig[K];
+    }
+    if (key in this.envOverrides) {
+      return this.envOverrides[key] as DeeperConfig[K];
+    }
+    if (key in this.projectConfig) {
+      return this.projectConfig[key] as DeeperConfig[K];
+    }
+    if (key in this.userConfig) {
+      return this.userConfig[key] as DeeperConfig[K];
+    }
+    return this.defaults[key];
+  }
+
+  set<K extends keyof DeeperConfig>(key: K, value: DeeperConfig[K], scope: 'cli' | 'project' | 'user'): void {
+    switch (scope) {
+      case 'cli':
+        this.cliOverrides[key] = value;
+        break;
+      case 'project':
+        this.projectConfig[key] = value;
+        break;
+      case 'user':
+        this.userConfig[key] = value;
+        break;
+    }
+  }
+
+  setCliOverrides(overrides: Partial<DeeperConfig>): void {
+    this.cliOverrides = { ...overrides };
+  }
+
+  getAll(): DeeperConfig {
+    return {
+      ...this.defaults,
+      ...this.userConfig,
+      ...this.projectConfig,
+      ...this.envOverrides,
+      ...this.cliOverrides,
+    };
+  }
+
+  private readJSONFile(path: string): Partial<DeeperConfig> {
+    try {
+      if (existsSync(path)) {
+        const content = readFileSync(path, 'utf-8');
+        return JSON.parse(content) as Partial<DeeperConfig>;
+      }
+    } catch {
+    }
+    return {};
+  }
+
+  private readEnvOverrides(): Partial<DeeperConfig> {
+    const overrides: Partial<DeeperConfig> = {};
+    const envMap: Record<string, keyof DeeperConfig> = {
+      DEEPER_MODEL: 'model',
+      DEEPER_API_KEY: 'apiKey',
+      DEEPER_BASE_URL: 'baseUrl',
+      DEEPER_TEMPERATURE: 'temperature',
+      DEEPER_MAX_TOKENS: 'maxTokens',
+      DEEPER_THINK_ENABLED: 'thinkEnabled',
+      DEEPER_THINK_BUDGET: 'thinkBudget',
+      DEEPER_LOG_LEVEL: 'logLevel',
+      DEEPER_MAX_RETRIES: 'maxRetries',
+      DEEPER_TIMEOUT: 'timeoutMs',
+    };
+
+    for (const [envKey, configKey] of Object.entries(envMap)) {
+      const value = process.env[envKey];
+      if (value !== undefined) {
+        switch (typeof DEFAULT_CONFIG[configKey]) {
+          case 'number':
+            (overrides as Record<string, unknown>)[configKey] = Number(value);
+            break;
+          case 'boolean':
+            (overrides as Record<string, unknown>)[configKey] = value.toLowerCase() === 'true' || value === '1';
+            break;
+          default:
+            (overrides as Record<string, unknown>)[configKey] = value;
+            break;
+        }
+      }
+    }
+
+    return overrides;
+  }
+}
+
+let cachedConfig: DeeperConfig | null = null;
+
+const KEY_ALIASES: Record<string, keyof DeeperConfig> = {
+  api_key: 'apiKey',
+  'api-key': 'apiKey',
+  base_url: 'baseUrl',
+  'base-url': 'baseUrl',
+  max_tokens: 'maxTokens',
+  'max-tokens': 'maxTokens',
+  think_enabled: 'thinkEnabled',
+  'think-enabled': 'thinkEnabled',
+  think_budget: 'thinkBudget',
+  'think-budget': 'thinkBudget',
+  log_level: 'logLevel',
+  'log-level': 'logLevel',
+  max_retries: 'maxRetries',
+  'max-retries': 'maxRetries',
+  timeout_ms: 'timeoutMs',
+  'timeout-ms': 'timeoutMs',
+  max_sub_agents: 'maxSubAgents',
+  'max-sub-agents': 'maxSubAgents',
+  max_recursion_depth: 'maxRecursionDepth',
+  'max-recursion-depth': 'maxRecursionDepth',
+  mcp_servers: 'mcpServers',
+  'mcp-servers': 'mcpServers',
+};
+
+function normalizeConfig(raw: Record<string, unknown>): Partial<DeeperConfig> {
+  const result: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(raw)) {
+    const canonical = KEY_ALIASES[key] || key;
+    result[canonical] = value;
+  }
+  return result as Partial<DeeperConfig>;
+}
+
+export function loadConfig(): DeeperConfig {
+  if (cachedConfig) return cachedConfig;
+  try {
+    if (existsSync(DEEPER_CONFIG_FILE)) {
+      const raw = readFileSync(DEEPER_CONFIG_FILE, 'utf-8');
+      const parsed = JSON.parse(raw) as Record<string, unknown>;
+      cachedConfig = { ...DEFAULT_CONFIG, ...normalizeConfig(parsed) };
+    } else {
+      cachedConfig = { ...DEFAULT_CONFIG };
+    }
+  } catch {
+    cachedConfig = { ...DEFAULT_CONFIG };
+  }
+  return cachedConfig;
+}
+
+export function saveConfig(config?: DeeperConfig): void {
+  if (config) cachedConfig = { ...config };
+  if (!cachedConfig) cachedConfig = { ...DEFAULT_CONFIG };
+  const dir = dirname(DEEPER_CONFIG_FILE);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  writeFileSync(DEEPER_CONFIG_FILE, JSON.stringify(cachedConfig, null, 2), 'utf-8');
+}
+
+export function getConfig(): DeeperConfig {
+  return cachedConfig ?? loadConfig();
+}
+
+export function updateConfig(partial: Partial<DeeperConfig>): DeeperConfig {
+  const current = getConfig();
+  cachedConfig = { ...current, ...partial };
+  saveConfig();
+  return cachedConfig;
+}
+
+export function resetConfig(): DeeperConfig {
+  cachedConfig = { ...DEFAULT_CONFIG };
+  saveConfig();
+  return cachedConfig;
+}
+
+export function getConfigValue<K extends keyof DeeperConfig>(key: K): DeeperConfig[K] {
+  return getConfig()[key];
+}
+
+export function setConfigValue<K extends keyof DeeperConfig>(key: K, value: DeeperConfig[K]): void {
+  updateConfig({ [key]: value } as unknown as Partial<DeeperConfig>);
+}
+
+export function getApiKey(): string {
+  return getConfig().apiKey || process.env.DEEPSEEK_API_KEY || '';
+}
+
+export function getModel(): string {
+  return getConfig().model;
+}
+
+export function getBaseUrl(): string {
+  return getConfig().baseUrl;
+}
+
+export const configManager = { load: () => loadConfig(), save: saveConfig, get: getConfigValue, set: setConfigValue, getAll: getConfig };

package/src/core/constants.ts

@@ -0,0 +1,49 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import process from 'node:process';
+
+export const DEEPER_VERSION = '1.0.0';
+export const DEEPER_NAME = 'DeeperCode';
+export const DEEPER_HOME = join(process.env.DEEPER_HOME || join(homedir(), '.deeper'));
+export const DEEPER_CONFIG_FILE = join(DEEPER_HOME, 'config.json');
+export const DEEPER_MCP_FILE = join(DEEPER_HOME, 'mcp.json');
+export const DEEPER_SKILLS_DIR = join(DEEPER_HOME, 'skills');
+export const DEEPER_SESSIONS_DIR = join(DEEPER_HOME, 'sessions');
+export const DEEPER_LOGS_DIR = join(DEEPER_HOME, 'logs');
+export const DEEPER_MEMORY_FILE = join(DEEPER_HOME, 'memory.json');
+export const PROJECT_CONFIG_DIR = '.deeper';
+export const PROJECT_CONFIG_FILE = join(PROJECT_CONFIG_DIR, 'config.json');
+export const PROJECT_SKILLS_DIR = join(PROJECT_CONFIG_DIR, 'skills');
+
+export const DEEPSEEK_BASE_URL = 'https://api.deepseek.com';
+export const DEEPSEEK_DEFAULT_MODEL = 'deepseek-v4-pro';
+export const DEEPSEEK_MODELS = ['deepseek-v4-pro', 'deepseek-v4-flash'] as const;
+export type DeepSeekModel = typeof DEEPSEEK_MODELS[number];
+export const DEEPSEEK_MAX_TOKENS = 1_048_576;
+export const DEEPSEEK_THINK_BUDGET = 16000;
+
+export const AGENT_MAX_SUB_AGENTS = 5;
+export const AGENT_MAX_RECURSION_DEPTH = 2;
+export const AGENT_SUB_AGENT_TIMEOUT_MS = 120000;
+export const AGENT_MAX_CONCURRENT_TOOLS = 3;
+
+export const CONTEXT_MAX_TOKENS = 1_048_576;
+export const CONTEXT_AUTO_SUMMARIZE_THRESHOLD = 786_432;
+export const CONTEXT_HISTORY_SIZE = 80;
+export const CONTEXT_FILE_LIMIT = 50_000;
+
+export const CONTEXT_COMPRESSION_STAGES = [
+  { threshold: 0.7, strategy: 'light' },
+  { threshold: 0.85, strategy: 'aggressive' },
+  { threshold: 0.95, strategy: 'emergency' },
+] as const;
+
+export const MCP_CONNECTION_TIMEOUT_MS = 10000;
+
+export const TOOL_CATEGORIES = [
+  'filesystem', 'search', 'shell', 'network',
+  'code', 'database', 'data', 'security',
+  'project', 'ai', 'system',
+] as const;
+
+export type ToolCategory = typeof TOOL_CATEGORIES[number];