mcp-osp-prompt 1.0.0

package/README.md

@@ -0,0 +1,358 @@
+# MCP Prompt Fetcher
+
+[![npm version](https://badge.fury.io/js/mcp-prompt-fetcher.svg)](https://badge.fury.io/js/mcp-prompt-fetcher)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A powerful MCP (Model Context Protocol) server that provides intelligent development prompts for Cursor, VS Code, and other IDE tools. Supports GitHub, GitLab, and local directory sources with automatic platform detection.
+
+## 🌟 Features
+
+- **🚀 Multi-Platform Support**: GitHub, GitLab, and local directories
+- **⚡ Auto-Detection**: Automatically detects platform from `RESOURCE_PATH`
+- **🔐 Unified Authentication**: Single `GIT_TOKEN` for both GitHub and GitLab
+- **🎛️ Flexible Dialogs**: Native system dialogs and web-based interfaces
+- **📦 Zero Configuration**: Works out-of-the-box with intelligent defaults
+- **🔄 Smart Caching**: Optimized remote file fetching with TTL-based caching (3-hour default)
+- **⚡ Lazy Loading**: Prompt content loaded on-demand to minimize API calls
+- **🛡️ Rate Limit Protection**: Automatic fallback to cached data and graceful degradation
+- **🎯 Efficient API Usage**: Only fetches file lists on startup, content on tool invocation
+- **🌍 Cross-Platform**: Full macOS and Linux compatibility
+
+## 📦 Installation
+
+```bash
+# Install globally (recommended)
+npm install -g mcp-prompt-fetcher
+
+# Or install locally
+npm install mcp-prompt-fetcher
+```
+
+## ⚙️ Quick Setup
+
+### 1️⃣ Simple Configuration (Only 2 environment variables needed!)
+
+Add to your IDE's MCP configuration file (e.g., `~/.cursor/mcp.json`):
+
+#### GitHub Repository
+```jsonc
+{
+  "mcpServers": {
+    "mcp-prompt-fetcher": {
+      "command": "mcp-prompt-fetcher",
+      "env": {
+        "RESOURCE_PATH": "username/repository",
+        "GIT_TOKEN": "ghp_your_github_token_here"
+      }
+    }
+  }
+}
+```
+
+#### GitLab Repository
+```jsonc
+{
+  "mcpServers": {
+    "mcp-prompt-fetcher": {
+      "command": "mcp-prompt-fetcher",
+      "env": {
+        "RESOURCE_PATH": "https://gitlab.com/group/project",
+        "GIT_TOKEN": "glpat-your_gitlab_token_here"
+      }
+    }
+  }
+}
+```
+
+#### Local Directory
+```jsonc
+{
+  "mcpServers": {
+    "mcp-prompt-fetcher": {
+      "command": "mcp-prompt-fetcher",
+      "env": {
+        "RESOURCE_PATH": "/path/to/your/prompts"
+      }
+    }
+  }
+}
+```
+
+#### Local Development & Testing
+```jsonc
+{
+  "osp-prompt-dev": {
+    "command": "node",
+    "args": [
+      "/absolute/path/to/osp-prompt/dev-mcp/server.js"
+    ],
+    "env": {
+      "RESOURCE_PATH": "/absolute/path/to/osp-prompt/osp",
+      "CACHE_DIR": "/absolute/path/to/osp-prompt/dev-mcp/.cache",
+      "AUTOMATED_MODE": "false",
+      "DEBUG_LOG": "true"
+    }
+  }
+}
+```
+
+**本地开发配置说明：**
+1. **克隆项目到本地：**
+   ```bash
+   git clone https://gitlab.com/your-org/osp-prompt.git
+   cd osp-prompt/dev-mcp
+   npm install
+   ```
+
+2. **目录结构要求：**
+   ```
+   osp-prompt/
+   ├── osp/                        # 资源根目录
+   │   ├── prompts/               # 提示词文件 (必需)
+   │   │   ├── design.prompt.md
+   │   │   ├── feature.prompt.md
+   │   │   └── ...
+   │   ├── projects/              # 项目文档 (可选)
+   │   │   ├── kiki-framework-wiki.md
+   │   │   └── ...
+   │   └── rules/                 # 编码规范 (可选)
+   │       ├── java-rules.md
+   │       └── python-rules.md
+   └── dev-mcp/                   # MCP 服务端
+       ├── server.js
+       ├── tests/                 # 测试脚本
+       └── .cache/                # 本地缓存目录
+   ```
+
+3. **配置 Cursor MCP：**
+   - 编辑 `~/.cursor/mcp.json` 或项目的 `.cursor/mcp.json`
+   - 将上述配置中的路径替换为你的实际绝对路径
+   - 重启 Cursor
+
+4. **运行端到端测试：**
+   ```bash
+   # 测试 dev-design 完整流程
+   node tests/test-dev-design-e2e.js
+   
+   # 测试 dev-feature 完整流程
+   node tests/test-dev-feature-e2e.js
+   ```
+
+5. **验证功能：**
+   - 在 Cursor 中打开任意项目
+   - 尝试调用 `dev-design` 或 `dev-feature` 工具
+   - 检查是否能看到：
+     * ✅ 可用的 projects 文档列表
+     * ✅ 可用的 rules 规范列表
+     * ✅ `load-resource` 工具使用说明
+     * ✅ 当前日期上下文
+
+**重要提示：**
+- **RESOURCE_PATH**: 本地模式下指向 `osp` 目录（包含 `prompts/`, `projects/`, `rules/` 子目录）
+- **多目录支持**: 系统会自动扫描 `osp/projects/` 和 `osp/rules/` 目录
+- **缓存目录**: 本地模式会将资源复制到 CACHE_DIR 进行缓存
+- **AUTOMATED_MODE**: 设为 `false` 启用交互式确认，`true` 为全自动模式
+
+### 2️⃣ Universal URL Parser - Handle Any Complex URL!
+
+Our advanced URL parser supports **any complex** GitLab and GitHub repository structure:
+
+#### Complex URL Examples That Work:
+
+```bash
+# GitLab with multi-level projects and complex branches
+"https://gitlab.com/Keccac256-evg/opensocial/osp-prompt/-/tree/master/dev-arch"
+"https://gitlab.com/group/subgroup/project/-/tree/feature/new-ui/src/components"
+"https://gitlab.com/company/team/service/-/tree/v1.2.3/docs/api"
+
+# GitHub with deep nested paths and feature branches
+"https://github.com/feast-dev/feast/tree/master/examples/java-demo/feature_repo/data"
+"https://github.com/microsoft/vscode/tree/main/src/vs/editor/contrib"
+"https://github.com/facebook/react/tree/feature/concurrent/packages/react/src"
+```
+
+#### Auto-Detection Results:
+
+| RESOURCE_PATH Format | Platform | Parsed As |
+|--------------------|----------|-----------|
+| `user/repo` | GitHub | `user/repo@main:dev-arch` |
+| `https://github.com/owner/repo/tree/branch/path/to/files` | GitHub | `owner/repo@branch:path/to/files` |
+| `https://gitlab.com/group/project/-/tree/branch/path` | GitLab | `group/project@branch:path` |
+| `https://gitlab.com/a/b/c/-/tree/feature/x/deep/nested/path` | GitLab | `a/b/c@feature/x:deep/nested/path` |
+| `/absolute/path` | Local | Local filesystem |
+| `./relative/path` | Local | Local filesystem |
+
+#### Smart Features:
+- ✅ **Multi-level projects**: `group/subgroup/project` 
+- ✅ **Complex branch names**: `feature/new-ui`, `hotfix/urgent-fix`
+- ✅ **Deep file paths**: `src/main/java/com/example/service`  
+- ✅ **Version tags**: `v1.2.3`, `release/2024.1`
+- ✅ **Automatic API URL generation** for both platforms
+
+## 🚀 Usage
+
+Once configured, the following tools become available in your IDE:
+
+- **`dev-feature`** - 🚀 Complete feature development (TDD workflow)
+- **`dev-design`** - 📐 System architecture design and planning
+- **`dev-refactor`** - 🔧 Code refactoring and optimization
+- **`dev-small`** - ⚡ Quick development and bug fixes
+- **`dev-tests`** - 🧪 Test coverage implementation (90%+ coverage)
+- **`dev-bugfix`** - 🐛 Precise problem analysis and minimal-impact fixes
+- **`dev-manual`** - 📋 Manual development type selection
+- **`dev-feedback`** - 🔄 Interactive step-by-step confirmation
+
+### Command Examples
+```
+dev-feature: Implement user authentication with email/phone login
+dev-design: Design microservices architecture for e-commerce platform
+dev-refactor: Improve code readability in user management module
+dev-small: Fix login button display issue in Safari browser
+dev-tests: Achieve 90%+ test coverage for user registration feature
+dev-bugfix: Debug intermittent session loss during user login
+```
+
+## 🔧 Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `RESOURCE_PATH` | *(required)* | Platform will be auto-detected from this path |
+| `GIT_TOKEN` | *(required for remote)* | GitHub (`ghp_...`) or GitLab (`glpat-...`) token |
+| `DIALOG_MODE` | `auto` | Dialog mode: `auto`\|`native`\|`browser` |
+| `AUTOMATED_MODE` | `true` | `false`=interactive confirmation, `true`=auto-execute |
+| `CACHE_TTL_SEC` | `86400` | Cache TTL in seconds (24 hours) |
+| `FORCE_UPDATE` | `false` | `true`=force remote fetch, bypass cache |
+| `DEBUG_LOG` | `false` | Enable detailed logging |
+
+## 🧪 Testing
+
+### Verify Installation
+```bash
+# Test local mode
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | RESOURCE_PATH="./dev-arch" mcp-prompt-fetcher
+
+# Test GitHub mode
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | RESOURCE_PATH="user/repo" GIT_TOKEN="your_token" mcp-prompt-fetcher
+
+# Test GitLab mode
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | RESOURCE_PATH="https://gitlab.com/group/project" GIT_TOKEN="your_token" mcp-prompt-fetcher
+```
+
+### Run Test Suite
+```bash
+npm test
+```
+
+### install npm
+```
+<!-- 自动递增打包并打git tag -->
+npm version patch|minor|major
+<!-- 本地打包查看即将发布的内容 -->
+npm pack --dry-run 
+<!-- 跑测试 + 审计脚本 -->
+npm run test:all  
+npm run audit:security
+<!-- 发布包 -->
+npm publish --access public
+<!-- 查看结果 -->
+npm info mcp-prompt-fetcher
+```
+
+## 📁 Directory Structure
+
+For local mode, your prompt directory should contain `.prompt.md` files:
+
+```
+dev-arch/
+├── feature.prompt.md      # → dev-feature tool
+├── design.prompt.md       # → dev-design tool
+├── refactor.prompt.md     # → dev-refactor tool
+├── small.prompt.md        # → dev-small tool
+├── tests.prompt.md        # → dev-tests tool
+└── bugfix.prompt.md       # → dev-bugfix tool
+```
+
+## 🎯 Best Practices
+
+### Recommended Configurations
+
+| Use Case | Configuration | Benefits |
+|----------|---------------|----------|
+| **Local Development** | Local mode + Native dialogs | Fast response, offline ready |
+| **Team Collaboration** | Remote mode + Browser dialogs | Beautiful UI, centralized management |
+| **CI/CD Pipeline** | Remote mode + `AUTOMATED_MODE=true` | No GUI dependencies |
+| **Step-by-Step Development** | Any mode + `AUTOMATED_MODE=false` | Interactive confirmation |
+
+### Token Permissions
+
+#### GitHub Token Requirements:
+- `public_repo` (for public repositories)
+- `repo` (for private repositories)
+
+#### GitLab Token Requirements:
+- `read_repository`
+- `read_api`
+
+## 🔍 Troubleshooting
+
+### Common Issues
+
+| Problem | Symptoms | Solution |
+|---------|----------|----------|
+| **Tools not responding** | Click tool, no response | 1. Check MCP config syntax<br/>2. Restart IDE<br/>3. Verify token validity |
+| **Dialog not showing** | Tool calls but no GUI | 1. Check `DIALOG_MODE` setting<br/>2. Try browser mode<br/>3. Check system permissions |
+| **Invalid content returned** | Wrong prompt content | 1. Check repository permissions<br/>2. Verify branch and file paths<br/>3. Clear cache |
+| **API Rate Limit (429 errors)** | Service starts with basic tools only | Normal behavior - basic tools work offline, cached content used when available |
+| **Slow first-time loading** | Long delay on first tool call | Expected - prompt content fetched on-demand, then cached for 3 hours |
+
+### Cache Management
+```bash
+# Clear cache
+rm -rf ~/.cache/prompts/*.md
+
+# Or force update
+export FORCE_UPDATE=true
+```
+
+### Debug Mode
+Set `DEBUG_LOG=true` to see detailed execution logs for troubleshooting.
+
+## 📋 API Reference
+
+### MCP Methods
+- `initialize` - MCP protocol handshake
+- `tools/list` - Get available tools (config-driven)
+- `tools/call` - Execute specific tool
+
+### Tool Schema
+Each tool follows this input schema:
+```json
+{
+  "type": "object",
+  "properties": {
+    "source": {
+      "type": "string",
+      "description": "Development requirements or task description"
+    }
+  },
+  "required": ["source"]
+}
+```
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙋 Support
+
+- **Documentation**: Check this README and inline code comments
+- **Issues**: [GitHub Issues](https://github.com/mcp-community/prompt-fetcher/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/mcp-community/prompt-fetcher/discussions)
+
+---
+
+**🎉 Happy Coding with Intelligent Prompts!**

package/config.js

@@ -0,0 +1,340 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { detectPlatformFromPath, parseRemotePath, createAuthHeaders, validatePlatformConfiguration } from './platform-utils.js';
+
+const force = (process.env.FORCE_UPDATE || 'false').toLowerCase() === 'true';
+
+// 🔵 REFACTOR: Task 2.1 - 提取Native弹窗宽度解析逻辑
+function parseNativeDialogWidth() {
+  const envValue = process.env.NATIVE_DIALOG_WIDTH;
+  const defaultWidth = 600; // 默认600px，在各个平台上都比较合适的宽度
+  const minWidth = 300;     // 最小宽度，确保内容可读
+  const maxWidth = 1200;    // 最大宽度，避免在小屏幕上过宽
+  
+  if (!envValue) {
+    return defaultWidth;
+  }
+  
+  const parsed = parseInt(envValue, 10);
+  
+  // 验证有效性和合理范围
+  if (isNaN(parsed) || parsed < minWidth || parsed > maxWidth) {
+    console.warn(`Warning: Invalid NATIVE_DIALOG_WIDTH value "${envValue}" (must be ${minWidth}-${maxWidth}px), using default ${defaultWidth}px`);
+    return defaultWidth;
+  }
+  
+  return parsed;
+}
+
+// 🔧 系统配置
+export const CFG = {
+  debug: process.env.DEBUG_LOG === 'true',
+  automatedMode: process.env.AUTOMATED_MODE !== 'false',
+  dialogMode: process.env.DIALOG_MODE || 'native',
+  defaultAuto: true,
+  force: force,
+  cacheDir: process.env.CACHE_DIR || path.join(process.env.HOME || '.', '.cache', 'prompts'),
+  ttl: parseInt(process.env.CACHE_TTL_SEC || '10800', 10), // 3小时默认TTL
+  
+  // 🔵 REFACTOR: Task 2.1 - Native弹窗宽度配置（仅针对native模式）
+  nativeDialogWidth: parseNativeDialogWidth(),
+  
+  tools: [],
+  
+  get config() {
+    return this;
+  },
+  
+  async initTools() {
+    if (!this.tools || this.tools.length === 0) {
+      this.tools = await initializeTools();
+    }
+    return this.tools || [];
+  }
+};
+
+// 🟢 GREEN: 统一资源配置 - 所有工具都加载完整的projects和rules列表
+// AI将根据具体需求自行选择使用哪些resources
+export const UNIFIED_RESOURCES = ['projects', 'rules'];
+
+// 🟢 GREEN: Task 1.1 - 实现目录扫描功能（支持本地和远程）
+export async function scanPromptFiles(devArchPath) {
+  try {
+    const files = await fs.readdir(devArchPath);
+    const promptFiles = files.filter(file => file.endsWith('.prompt.md'));
+    
+    return promptFiles.map(filename => {
+      const baseName = filename.replace('.prompt.md', '');
+      return {
+        filename,
+        toolName: `dev-${baseName}`,
+        filepath: path.join(devArchPath, filename),
+        source: filename // 本地模式下直接使用文件名作为source
+      };
+    });
+  } catch (error) {
+    console.warn(`Warning: Could not scan ${devArchPath}:`, error.message);
+    return [];
+  }
+}
+
+// 🟢 GREEN: Task 1.2 - 实现自动配置生成功能（简化版）
+export async function generateAutoPromptTools() {
+  try {
+    const resourcePath = process.env.RESOURCE_PATH;
+    if (!resourcePath) {
+      return getBasicPromptTools();
+    }
+    
+    const platform = detectPlatformFromPath(resourcePath);
+    let scannedFiles;
+    
+    if (platform === 'local') {
+      // 本地模式：扫描配置的本地目录
+      console.log(`[Config] Using local resource path: ${resourcePath}`);
+      scannedFiles = await scanPromptFiles(resourcePath);
+      
+      // 如果本地扫描失败或没有找到文件，回退到基础工具
+      if (scannedFiles.length === 0) {
+        console.warn(`Warning: No prompt files found in ${resourcePath}, falling back to basic tools`);
+        return getBasicPromptTools();
+      }
+    } else {
+      // 远程模式：从GitHub或GitLab获取prompt文件列表
+      console.log(`[Config] Using remote ${platform} prompt files from: ${resourcePath}`);
+      scannedFiles = await scanRemotePromptFiles();
+      
+      // 如果远程扫描失败或没有找到文件，回退到基础工具
+      if (scannedFiles.length === 0) {
+        console.warn(`Warning: No prompt files found from remote ${platform}, falling back to basic tools`);
+        return getBasicPromptTools();
+      }
+    }
+    
+    return scannedFiles.map(({ filename, toolName, source }) => ({
+      name: toolName,
+      type: 'prompt',
+      source: source,
+      description: `${toolName} prompt direct`,
+      schema: {
+        type: 'object',
+        properties: { source: { type: 'string' } },
+        required: ['source']
+      }
+    }));
+  } catch (error) {
+    console.error('[Config] Auto prompt tool generation failed:', error.message);
+    return getBasicPromptTools();
+  }
+}
+
+// 基础prompt工具（回退选项）
+function getBasicPromptTools() {
+  const basicTools = ['feature', 'bugfix', 'refactor', 'design', 'small', 'tests'];
+  return basicTools.map(tool => ({
+    name: `dev-${tool}`,
+    type: 'prompt',
+    source: `${tool}.prompt.md`,
+    description: `dev-${tool} prompt direct`,
+    schema: {
+      type: 'object',
+      properties: { source: { type: 'string' } },
+      required: ['source']
+    }
+  }));
+}
+
+/**
+ * 远程GitHub文件扫描
+ * @param {Object} pathInfo - 解析后的路径信息
+ * @returns {Array} 扫描到的文件列表
+ */
+async function scanRemoteGitHubFiles(pathInfo) {
+  if (!pathInfo) {
+    throw new Error('Invalid GitHub path info');
+  }
+  
+  const url = `${pathInfo.apiUrl}?ref=${pathInfo.branch}`;
+  const headers = createAuthHeaders('github', process.env.GIT_TOKEN);
+  
+  const requestOptions = { headers };
+  const response = await fetch(url, requestOptions);
+  if (!response.ok) {
+    // 构建详细的调试信息，隐藏敏感token信息
+    const debugHeaders = { ...headers };
+    
+    const requestInfo = `
+      REQUEST INFO: \n
+      - URL: ${url} \n
+      - Method: GET \n
+      - Headers: ${JSON.stringify(debugHeaders, null, 2)} \n
+      - Response Status: ${response.status} \n
+      - Response StatusText: ${response.statusText} \n`;
+    
+    throw new Error(`GitHub API error: ${requestInfo}`);
+  }
+  
+  const files = await response.json();
+  return files
+    .filter(file => file.type === 'file' && file.name.endsWith('.prompt.md'))
+    .map(file => {
+      const baseName = file.name.replace('.prompt.md', '');
+      return {
+        filename: file.name,
+        toolName: `dev-${baseName}`,
+        source: pathInfo.path ? `${pathInfo.path}/${file.name}` : file.name
+      };
+    });
+}
+
+/**
+ * 远程GitLab文件扫描
+ * @param {Object} pathInfo - 解析后的路径信息
+ * @returns {Array} 扫描到的文件列表
+ */
+async function scanRemoteGitLabFiles(pathInfo) {
+  if (!pathInfo) {
+    throw new Error('Invalid GitLab path info');
+  }
+  
+  const headers = createAuthHeaders('gitlab', process.env.GIT_TOKEN);
+  
+  const requestOptions = { headers };
+  const response = await fetch(pathInfo.apiUrl, requestOptions);
+  if (!response.ok) {
+    // 构建详细的调试信息，隐藏敏感token信息
+    const debugHeaders = { ...headers };
+    
+    const requestInfo = `
+      REQUEST INFO: \n
+      - URL: ${pathInfo.apiUrl} \n
+      - Method: GET \n
+      - Headers: ${JSON.stringify(debugHeaders, null, 2)} \n
+      - Response Status: ${response.status} \n
+      - Response StatusText: ${response.statusText} \n`;
+    
+    throw new Error(`GitLab API error: ${requestInfo}`);
+  }
+  
+  const files = await response.json();
+  return files
+    .filter(file => file.type === 'blob' && file.name.endsWith('.prompt.md'))
+    .map(file => {
+      const baseName = file.name.replace('.prompt.md', '');
+      return {
+        filename: file.name,
+        toolName: `dev-${baseName}`,
+        source: pathInfo.path ? `${pathInfo.path}/${file.name}` : file.name
+      };
+    });
+}
+
+// 统一远程扫描函数 (简化版 + 缓存机制)
+async function scanRemotePromptFiles() {
+  validatePlatformConfiguration();
+  
+  const resourcePath = process.env.RESOURCE_PATH;
+  const platform = detectPlatformFromPath(resourcePath);
+  
+  if (platform === 'local') {
+    throw new Error('scanRemotePromptFiles called for local path');
+  }
+  
+  // 检查缓存的文件列表
+  const cacheFile = path.join(CFG.cacheDir, 'file-list.json');
+  
+  // 如果不强制更新且缓存存在且未过期，使用缓存
+  if (!force) {
+    try {
+      const stat = await fs.stat(cacheFile);
+      const cacheAge = Date.now() - stat.mtimeMs;
+      const cacheAgeMinutes = Math.round(cacheAge / 1000 / 60);
+      
+      if (cacheAge < CFG.ttl * 1000) {
+        const cachedList = await fs.readFile(cacheFile, 'utf8');
+        console.log(`[Config] Using cached file list (age: ${cacheAgeMinutes}min)`);
+        return JSON.parse(cachedList);
+      }
+    } catch (_) {
+      // 缓存不存在或无效，继续获取
+    }
+  }
+  
+  // 从远程获取文件列表
+  try {
+    console.log(`[Config] Fetching fresh file list from ${platform}...`);
+    
+    let scannedFiles = [];
+    
+    if (platform === 'github') {
+      scannedFiles = await scanRemoteGitHubFiles(parseRemotePath(resourcePath));
+    } else if (platform === 'gitlab') {
+      scannedFiles = await scanRemoteGitLabFiles(parseRemotePath(resourcePath));
+    }
+    
+    // 缓存结果
+    await fs.writeFile(cacheFile, JSON.stringify(scannedFiles, null, 2), 'utf8');
+    console.log(`[Config] Cached ${scannedFiles.length} files to ${cacheFile}`);
+    
+    return scannedFiles;
+  } catch (error) {
+    // API失败时尝试使用旧缓存
+    console.warn(`[Config] Remote scanning failed: ${error.message}`);
+    try {
+      const cachedList = await fs.readFile(cacheFile, 'utf8');
+      console.log(`[Config] Using stale cache due to API failure`);
+      return JSON.parse(cachedList);
+    } catch (_) {
+      console.error('[Config] No cache available, returning empty list');
+      return [];
+    }
+  }
+}
+
+// 🟢 GREEN: Task 1.3 - 集成自动工具配置
+async function initializeTools() {
+  const autoPromptTools = await generateAutoPromptTools();
+  
+  // Handler-based tools (手动配置的特殊工具)
+  const handlerTools = [
+    {
+      name: 'dev-feedback',
+      type: 'handler',
+      handler: 'handleDevFeedback',
+      description: '反馈确认工具',
+      schema: {
+        type: 'object',
+        properties: {
+          title: { type: 'string' },
+          message: { type: 'string' },
+          options: { type: 'array', items: { type: 'string' } }
+        },
+        required: ['title', 'message']
+      }
+    },
+    {
+      name: 'dev-manual',
+      type: 'handler', 
+      handler: 'handleDevManual',
+      description: '手动选择开发类型',
+      schema: {
+        type: 'object',
+        properties: {
+          random_string: { description: 'Dummy parameter for no-parameter tools', type: 'string' }
+        },
+        required: ['random_string']
+      }
+    }
+  ];
+
+  const allTools = [...autoPromptTools, ...handlerTools];
+  console.log(`[Config] Initialized ${allTools.length} tools (${autoPromptTools.length} prompt + ${handlerTools.length} handler)`);
+  
+  return allTools;
+}
+
+// Initialize cache directory
+await fs.mkdir(CFG.cacheDir, { recursive: true });
+
+// 兼容性导出 - 为prompt-manager提供配置
+export { scanRemotePromptFiles };