@adversity/coding-tool-x 3.0.6 → 3.1.1

package/src/server/api/permissions.js

@@ -1,385 +0,0 @@
-/**
- * Command Permissions API 路由
- *
- * 管理 Claude Code / Codex / Gemini CLI 命令执行权限
- *
- * 三个 CLI 工具的权限控制机制：
- *
- * 1. Claude Code:
- *    - 配置文件: ~/.claude/settings.json (用户级) 或 .claude/settings.json (项目级)
- *    - 权限格式: permissions.allow / permissions.deny 数组
- *    - 支持通配符: Bash(npm run *), Read(./src/**)
- *
- * 2. Codex CLI:
- *    - 启动参数: --ask-for-approval never/on-request/on-failure
- *    - 沙箱模式: --sandbox read-only/workspace-write/danger-full-access
- *    - YOLO 模式: --yolo 或 --dangerously-bypass-approvals-and-sandbox
- *
- * 3. Gemini CLI:
- *    - 启动参数: --approval-mode default/auto_edit/yolo
- *    - 允许工具: --allowed-tools "ShellTool(git status)"
- *    - 沙箱: --sandbox / -s
- */
-
-const express = require('express');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const permissionTemplatesService = require('../services/permission-templates-service');
-
-const router = express.Router();
-
-// Claude Code 设置文件路径
-function getClaudeSettingsPath(projectPath) {
-  if (projectPath) {
-    return path.join(projectPath, '.claude', 'settings.json');
-  }
-  return path.join(os.homedir(), '.claude', 'settings.json');
-}
-
-// 读取 Claude Code settings.json
-function readClaudeSettings(projectPath) {
-  const settingsPath = getClaudeSettingsPath(projectPath);
-  try {
-    if (fs.existsSync(settingsPath)) {
-      const content = fs.readFileSync(settingsPath, 'utf-8');
-      return JSON.parse(content);
-    }
-  } catch (err) {
-    console.error('[Permissions API] Error reading Claude settings:', err);
-  }
-  return {};
-}
-
-// 保存 Claude Code settings.json
-function saveClaudeSettings(projectPath, settings) {
-  const settingsPath = getClaudeSettingsPath(projectPath);
-  const settingsDir = path.dirname(settingsPath);
-
-  try {
-    // 确保目录存在
-    if (!fs.existsSync(settingsDir)) {
-      fs.mkdirSync(settingsDir, { recursive: true });
-    }
-
-    // 写入文件
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
-
-    // 验证文件已创建
-    if (!fs.existsSync(settingsPath)) {
-      throw new Error('文件写入后验证失败，文件未被创建');
-    }
-
-    return { success: true, path: settingsPath };
-  } catch (err) {
-    console.error('[Permissions API] Error saving Claude settings:', err);
-    throw new Error(`保存配置文件失败: ${err.message}`);
-  }
-}
-
-// 全局 all-allow 状态（内存中）
-let globalAllAllowEnabled = process.env.CLAUDE_ALL_ALLOW === 'true';
-
-/**
- * 获取项目的命令执行权限设置
- * GET /api/permissions
- * Query: projectPath - 项目路径, cliType - CLI 类型 (claude/codex/gemini)
- */
-router.get('/', (req, res) => {
-  try {
-    const { projectPath, cliType = 'claude' } = req.query;
-
-    if (!projectPath) {
-      return res.status(400).json({
-        success: false,
-        message: '缺少 projectPath 参数'
-      });
-    }
-
-    if (!fs.existsSync(projectPath)) {
-      return res.status(404).json({
-        success: false,
-        message: '项目路径不存在'
-      });
-    }
-
-    // 读取 Claude Code 配置（所有 CLI 工具共用此配置管理）
-    const settings = readClaudeSettings(projectPath);
-    const permissions = settings.permissions || {};
-
-    res.json({
-      success: true,
-      cliType,
-      settings: {
-        // Claude Code 格式
-        allow: permissions.allow || [],
-        deny: permissions.deny || [],
-        // 兼容旧格式
-        allowedCommands: permissions.allow || [],
-        denyCommands: permissions.deny || []
-      }
-    });
-  } catch (err) {
-    console.error('[Permissions API] Get permissions error:', err);
-    res.status(500).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 保存项目的命令执行权限设置
- * POST /api/permissions
- * Body: { projectPath, settings: { allow, deny } }
- */
-router.post('/', (req, res) => {
-  try {
-    const { projectPath, settings: newPermissions } = req.body;
-
-    if (!projectPath) {
-      return res.status(400).json({
-        success: false,
-        message: '缺少 projectPath 参数'
-      });
-    }
-
-    if (!fs.existsSync(projectPath)) {
-      return res.status(404).json({
-        success: false,
-        message: '项目路径不存在'
-      });
-    }
-
-    // 读取现有设置
-    const settings = readClaudeSettings(projectPath);
-
-    // 更新权限设置（使用 Claude Code 的标准格式）
-    settings.permissions = {
-      allow: newPermissions?.allow || newPermissions?.allowedCommands || [],
-      deny: newPermissions?.deny || newPermissions?.denyCommands || []
-    };
-
-    // 保存设置
-    const saveResult = saveClaudeSettings(projectPath, settings);
-
-    res.json({
-      success: true,
-      message: '权限设置已保存',
-      savedTo: '.claude/settings.json',
-      fullPath: saveResult.path
-    });
-  } catch (err) {
-    console.error('[Permissions API] Save permissions error:', err);
-    res.status(500).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 获取全局 all-allow 模式状态
- * GET /api/permissions/all-allow
- */
-router.get('/all-allow', (req, res) => {
-  try {
-    res.json({
-      success: true,
-      enabled: globalAllAllowEnabled,
-      note: '此设置通过启动命令参数控制，如 claude --dangerously-skip-permissions'
-    });
-  } catch (err) {
-    console.error('[Permissions API] Get all-allow status error:', err);
-    res.status(500).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 设置全局 all-allow 模式（运行时）
- * POST /api/permissions/all-allow
- * Body: { enabled }
- */
-router.post('/all-allow', (req, res) => {
-  try {
-    const { enabled } = req.body;
-    globalAllAllowEnabled = !!enabled;
-
-    res.json({
-      success: true,
-      enabled: globalAllAllowEnabled,
-      message: enabled ? 'All-Allow 模式已启用' : 'All-Allow 模式已禁用'
-    });
-  } catch (err) {
-    console.error('[Permissions API] Set all-allow status error:', err);
-    res.status(500).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 获取所有权限模版（内置 + 自定义）
- * GET /api/permissions/templates
- */
-router.get('/templates', (req, res) => {
-  try {
-    const templates = permissionTemplatesService.getAllTemplates();
-    res.json({
-      success: true,
-      data: templates
-    });
-  } catch (err) {
-    console.error('[Permissions API] Get templates error:', err);
-    res.status(500).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 获取单个权限模版
- * GET /api/permissions/templates/:id
- */
-router.get('/templates/:id', (req, res) => {
-  try {
-    const template = permissionTemplatesService.getTemplateById(req.params.id);
-    if (!template) {
-      return res.status(404).json({
-        success: false,
-        message: '模版不存在'
-      });
-    }
-    res.json({
-      success: true,
-      data: template
-    });
-  } catch (err) {
-    console.error('[Permissions API] Get template error:', err);
-    res.status(500).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 创建自定义权限模版
- * POST /api/permissions/templates
- */
-router.post('/templates', (req, res) => {
-  try {
-    const template = permissionTemplatesService.createTemplate(req.body);
-    res.json({
-      success: true,
-      data: template,
-      message: '模版创建成功'
-    });
-  } catch (err) {
-    console.error('[Permissions API] Create template error:', err);
-    res.status(400).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 更新自定义权限模版
- * PUT /api/permissions/templates/:id
- */
-router.put('/templates/:id', (req, res) => {
-  try {
-    const template = permissionTemplatesService.updateTemplate(req.params.id, req.body);
-    res.json({
-      success: true,
-      data: template,
-      message: '模版更新成功'
-    });
-  } catch (err) {
-    console.error('[Permissions API] Update template error:', err);
-    res.status(400).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 删除自定义权限模版
- * DELETE /api/permissions/templates/:id
- */
-router.delete('/templates/:id', (req, res) => {
-  try {
-    permissionTemplatesService.deleteTemplate(req.params.id);
-    res.json({
-      success: true,
-      message: '模版删除成功'
-    });
-  } catch (err) {
-    console.error('[Permissions API] Delete template error:', err);
-    res.status(400).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-/**
- * 获取各 CLI 工具的启动参数配置说明
- * GET /api/permissions/cli-config
- */
-router.get('/cli-config', (req, res) => {
-  try {
-    const cliConfigs = {
-      claude: {
-        name: 'Claude Code',
-        configFile: '.claude/settings.json',
-        userConfigFile: '~/.claude/settings.json',
-        permissionFormat: {
-          example: {
-            permissions: {
-              allow: ['Bash(npm run:*)', 'Read(./src/**)'],
-              deny: ['Bash(rm:*)', 'Read(.env)']
-            }
-          }
-        },
-        allAllowFlag: '--dangerously-skip-permissions',
-        docs: 'https://docs.anthropic.com/en/docs/claude-code'
-      },
-      codex: {
-        name: 'Codex CLI',
-        sandboxModes: ['read-only', 'workspace-write'],
-        approvalModes: ['suggest', 'auto-edit'],
-        allAllowFlag: '--dangerously-bypass-approvals-and-sandbox',
-        example: 'codex --approval-mode auto-edit --sandbox workspace-write "task"',
-        docs: 'https://github.com/openai/codex'
-      },
-      gemini: {
-        name: 'Gemini CLI',
-        allowedToolsFlag: '--allowedTools "ShellTool(git status)"',
-        sandboxFlag: '--sandbox / -s',
-        allAllowFlag: '--yolo',
-        docs: 'https://github.com/google-gemini/gemini-cli'
-      }
-    };
-
-    res.json({
-      success: true,
-      cliConfigs
-    });
-  } catch (err) {
-    console.error('[Permissions API] Get CLI config error:', err);
-    res.status(500).json({
-      success: false,
-      message: err.message
-    });
-  }
-});
-
-module.exports = router;

package/src/server/services/permission-templates-service.js

@@ -1,308 +0,0 @@
-/**
- * Permission Templates Service
- *
- * 管理权限配置模版的 CRUD 操作
- * 支持内置模版和自定义模版
- */
-
-const fs = require('fs');
-const path = require('path');
-const { PATHS } = require('../../config/paths');
-
-// 权限模版存储文件
-const TEMPLATES_FILE = path.join(PATHS.config, 'permission-templates.json');
-
-// 内置权限模版
-const BUILTIN_TEMPLATES = [
-  {
-    id: 'safe',
-    name: '安全模式',
-    description: '仅允许只读命令，危险操作需要确认',
-    permissions: {
-      allow: [
-        'Bash(cat:*)',
-        'Bash(ls:*)',
-        'Bash(pwd)',
-        'Bash(echo:*)',
-        'Bash(head:*)',
-        'Bash(tail:*)',
-        'Bash(grep:*)',
-        'Read(*)'
-      ],
-      deny: [
-        'Bash(rm:*)',
-        'Bash(sudo:*)',
-        'Bash(git push:*)',
-        'Bash(git reset --hard:*)',
-        'Bash(chmod:*)',
-        'Bash(chown:*)',
-        'Edit(*)'
-      ]
-    },
-    isBuiltin: true
-  },
-  {
-    id: 'balanced',
-    name: '平衡模式',
-    description: '允许常用开发命令，危险操作需要确认',
-    permissions: {
-      allow: [
-        'Bash(cat:*)',
-        'Bash(ls:*)',
-        'Bash(pwd)',
-        'Bash(echo:*)',
-        'Bash(head:*)',
-        'Bash(tail:*)',
-        'Bash(grep:*)',
-        'Bash(find:*)',
-        'Bash(git status)',
-        'Bash(git diff:*)',
-        'Bash(git log:*)',
-        'Bash(npm run:*)',
-        'Bash(pnpm:*)',
-        'Bash(yarn:*)',
-        'Read(*)',
-        'Edit(*)'
-      ],
-      deny: [
-        'Bash(rm -rf:*)',
-        'Bash(sudo:*)',
-        'Bash(git push --force:*)',
-        'Bash(git reset --hard:*)'
-      ]
-    },
-    isBuiltin: true
-  },
-  {
-    id: 'permissive',
-    name: '宽松模式',
-    description: '允许大多数命令，仅阻止极度危险的操作',
-    permissions: {
-      allow: [
-        'Bash(*)',
-        'Read(*)',
-        'Edit(*)'
-      ],
-      deny: [
-        'Bash(rm -rf /*)',
-        'Bash(sudo rm -rf:*)'
-      ]
-    },
-    isBuiltin: true
-  }
-];
-
-/**
- * 确保配置目录存在
- */
-function ensureDir(dirPath) {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-}
-
-/**
- * 加载所有模版（内置 + 自定义）
- */
-/**
- * 加载所有模版（内置 + 自定义）
- * 内置模版可被用户覆盖修改
- */
-/**
- * 加载所有模版（内置 + 自定义）
- * 内置模版可被用户覆盖修改或隐藏
- */
-function loadTemplates() {
-  try {
-    if (fs.existsSync(TEMPLATES_FILE)) {
-      const content = fs.readFileSync(TEMPLATES_FILE, 'utf8');
-      const data = JSON.parse(content);
-      
-      // 分离自定义模版和隐藏标记
-      const customTemplates = (data.custom || []).filter(t => !t._hidden);
-      const hiddenIds = (data.custom || []).filter(t => t._hidden).map(t => t.id);
-      
-      const customIds = customTemplates.map(t => t.id);
-      
-      // 过滤掉已被自定义覆盖或隐藏的内置模版
-      const effectiveBuiltin = BUILTIN_TEMPLATES.filter(t => 
-        !customIds.includes(t.id) && !hiddenIds.includes(t.id)
-      );
-      
-      return {
-        builtin: effectiveBuiltin,
-        custom: customTemplates,
-        all: [...customTemplates, ...effectiveBuiltin] // 自定义优先
-      };
-    }
-  } catch (error) {
-    console.error('[PermissionTemplates] 加载模版失败:', error.message);
-  }
-
-  return {
-    builtin: BUILTIN_TEMPLATES,
-    custom: [],
-    all: BUILTIN_TEMPLATES
-  };
-}
-
-/**
- * 保存自定义模版
- */
-function saveCustomTemplates(customTemplates) {
-  ensureDir(PATHS.config);
-  fs.writeFileSync(TEMPLATES_FILE, JSON.stringify({ custom: customTemplates }, null, 2), 'utf8');
-}
-
-/**
- * 获取所有模版
- */
-/**
- * 获取所有模版（合并后的最终列表）
- */
-function getAllTemplates() {
-  const { all } = loadTemplates();
-  return all;
-}
-
-/**
- * 根据 ID 获取模版
- */
-function getTemplateById(id) {
-  const templates = getAllTemplates();
-  return templates.find(t => t.id === id) || null;
-}
-
-/**
- * 创建自定义模版
- */
-function createTemplate(template) {
-  const { custom } = loadTemplates();
-
-  // 验证必填字段
-  if (!template.name || !template.name.trim()) {
-    throw new Error('模版名称不能为空');
-  }
-
-  // 生成唯一 ID
-  const id = `custom-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
-
-  const newTemplate = {
-    id,
-    name: template.name.trim(),
-    description: template.description || '',
-    permissions: {
-      allow: template.permissions?.allow || [],
-      deny: template.permissions?.deny || []
-    },
-    isBuiltin: false,
-    createdAt: new Date().toISOString()
-  };
-
-  custom.push(newTemplate);
-  saveCustomTemplates(custom);
-
-  return newTemplate;
-}
-
-/**
- * 更新自定义模版
- */
-/**
- * 更新权限模版（包括内置模版）
- * 编辑内置模版时，会在自定义列表中创建覆盖版本
- */
-function updateTemplate(id, updates) {
-  const { custom, all } = loadTemplates();
-  
-  // 查找模版（先查自定义，再查所有）
-  const existingTemplate = all.find(t => t.id === id);
-  if (!existingTemplate) {
-    throw new Error('模版不存在');
-  }
-
-  // 验证名称
-  if (updates.name !== undefined && !updates.name.trim()) {
-    throw new Error('模版名称不能为空');
-  }
-
-  const updated = {
-    ...existingTemplate,
-    name: updates.name?.trim() ?? existingTemplate.name,
-    description: updates.description ?? existingTemplate.description,
-    permissions: updates.permissions ?? existingTemplate.permissions,
-    isBuiltin: false, // 编辑后标记为自定义（覆盖内置）
-    updatedAt: new Date().toISOString()
-  };
-
-  // 如果是编辑内置模版，则添加到自定义列表中（覆盖）
-  const customIndex = custom.findIndex(t => t.id === id);
-  if (customIndex !== -1) {
-    custom[customIndex] = updated;
-  } else {
-    custom.push(updated);
-  }
-  
-  saveCustomTemplates(custom);
-  return updated;
-}
-
-/**
- * 删除自定义模版
- */
-/**
- * 删除权限模版（包括内置模版）
- * 删除内置模版时，会在自定义列表中添加隐藏标记
- */
-/**
- * 删除权限模版（包括内置模版）
- * 删除内置模版时，会在自定义列表中添加隐藏标记
- */
-function deleteTemplate(id) {
-  try {
-    if (!fs.existsSync(TEMPLATES_FILE)) {
-      ensureDir(PATHS.config);
-      fs.writeFileSync(TEMPLATES_FILE, JSON.stringify({ custom: [] }, null, 2), 'utf8');
-    }
-    
-    const content = fs.readFileSync(TEMPLATES_FILE, 'utf8');
-    const data = JSON.parse(content);
-    const customList = data.custom || [];
-    
-    // 检查是否为内置模版
-    const isBuiltin = BUILTIN_TEMPLATES.some(t => t.id === id);
-    
-    if (isBuiltin) {
-      // 内置模版：添加隐藏标记
-      const hideMarker = {
-        id,
-        _hidden: true,
-        deletedAt: new Date().toISOString()
-      };
-      customList.push(hideMarker);
-      fs.writeFileSync(TEMPLATES_FILE, JSON.stringify({ custom: customList }, null, 2), 'utf8');
-    } else {
-      // 自定义模版：直接删除
-      const index = customList.findIndex(t => t.id === id && !t._hidden);
-      if (index === -1) {
-        throw new Error('模版不存在');
-      }
-      customList.splice(index, 1);
-      fs.writeFileSync(TEMPLATES_FILE, JSON.stringify({ custom: customList }, null, 2), 'utf8');
-    }
-
-    return true;
-  } catch (error) {
-    if (error.message === '模版不存在') throw error;
-    throw new Error('删除模版失败: ' + error.message);
-  }
-}
-
-module.exports = {
-  getAllTemplates,
-  getTemplateById,
-  createTemplate,
-  updateTemplate,
-  deleteTemplate,
-  BUILTIN_TEMPLATES
-};