mcp-osp-prompt 1.0.0 → 1.0.2

package/resource-manager.js

@@ -1,358 +0,0 @@
-/**
- * 资源管理器模块
- * 
- * 提供统一的资源访问API，用于获取projects和rules内容
- * Task 2.1 - 资源访问接口层
- */
-
-import fs from 'fs/promises';
-import path from 'path';
-import { CFG } from './config.js';
-
-/**
- * 读取资源缓存
- * @returns {Object|null} 缓存的资源对象
- */
-export async function readResourceCache() {
-  const cacheFile = path.join(CFG.cacheDir, 'resource-cache.json');
-  
-  try {
-    const data = await fs.readFile(cacheFile, 'utf8');
-    const resources = JSON.parse(data);
-    
-    if (resources && resources.prompts && resources.projects && resources.rules) {
-      return resources;
-    }
-    
-    return null;
-  } catch (error) {
-    console.warn(`[ResourceManager] No resource cache found: ${error.message}`);
-    return null;
-  }
-}
-
-/**
- * 获取项目列表
- * @returns {Array} 项目文档列表
- */
-export async function getProjectsList() {
-  try {
-    const cache = await readResourceCache();
-    
-    if (!cache || !cache.projects) {
-      console.warn('[ResourceManager] No projects found in cache');
-      return [];
-    }
-    
-    console.log(`[ResourceManager] Found ${cache.projects.length} projects`);
-    return cache.projects;
-  } catch (error) {
-    console.error(`[ResourceManager] Failed to get projects list: ${error.message}`);
-    return [];
-  }
-}
-
-/**
- * 获取项目文档内容
- * @param {String} projectName - 项目文件名 (如 'kiki-framework-wiki.md')
- * @returns {String|null} 项目文档内容
- */
-export async function getProjectContent(projectName) {
-  try {
-    // 项目文档缓存在 projects 子目录
-    const cacheFile = path.join(CFG.cacheDir, 'projects', projectName);
-    
-    const content = await fs.readFile(cacheFile, 'utf8');
-    console.log(`[ResourceManager] Loaded project: ${projectName} (${content.length} bytes)`);
-    
-    return content;
-  } catch (error) {
-    console.warn(`[ResourceManager] Failed to load project ${projectName}: ${error.message}`);
-    
-    // 尝试从远程拉取（TODO: 在后续优化中实现）
-    return null;
-  }
-}
-
-/**
- * 根据语言获取规则文件信息
- * @param {String} language - 语言名称 (如 'java', 'python')
- * @returns {Object|null} 规则文件信息
- */
-export async function getRulesByLanguage(language) {
-  try {
-    const cache = await readResourceCache();
-    
-    if (!cache || !cache.rules) {
-      console.warn('[ResourceManager] No rules found in cache');
-      return null;
-    }
-    
-    // 查找匹配的规则文件
-    const rule = cache.rules.find(r => r.language === language);
-    
-    if (rule) {
-      console.log(`[ResourceManager] Found rule for language: ${language}`);
-      return rule;
-    }
-    
-    console.warn(`[ResourceManager] No rule found for language: ${language}`);
-    return null;
-  } catch (error) {
-    console.error(`[ResourceManager] Failed to get rules for ${language}: ${error.message}`);
-    return null;
-  }
-}
-
-/**
- * 获取规则文档内容
- * @param {String} ruleFilename - 规则文件名 (如 'java-code-rules.md')
- * @returns {String|null} 规则文档内容
- */
-export async function getRuleContent(ruleFilename) {
-  try {
-    // 规则文档缓存在 rules 子目录
-    const cacheFile = path.join(CFG.cacheDir, 'rules', ruleFilename);
-    
-    const content = await fs.readFile(cacheFile, 'utf8');
-    console.log(`[ResourceManager] Loaded rule: ${ruleFilename} (${content.length} bytes)`);
-    
-    return content;
-  } catch (error) {
-    console.warn(`[ResourceManager] Failed to load rule ${ruleFilename}: ${error.message}`);
-    
-    // 尝试从远程拉取（TODO: 在后续优化中实现）
-    return null;
-  }
-}
-
-/**
- * 根据语言获取规则内容（便捷函数）
- * @param {String} language - 语言名称
- * @returns {String|null} 规则内容
- */
-export async function getRuleContentByLanguage(language) {
-  try {
-    const ruleInfo = await getRulesByLanguage(language);
-    
-    if (!ruleInfo) {
-      return null;
-    }
-    
-    return await getRuleContent(ruleInfo.filename);
-  } catch (error) {
-    console.error(`[ResourceManager] Failed to get rule content for ${language}: ${error.message}`);
-    return null;
-  }
-}
-
-/**
- * 获取所有可用的规则语言列表
- * @returns {Array} 语言名称数组
- */
-export async function getAvailableLanguages() {
-  try {
-    const cache = await readResourceCache();
-    
-    if (!cache || !cache.rules) {
-      return [];
-    }
-    
-    const languages = cache.rules
-      .map(r => r.language)
-      .filter(Boolean);
-    
-    console.log(`[ResourceManager] Available languages: ${languages.join(', ')}`);
-    return languages;
-  } catch (error) {
-    console.error(`[ResourceManager] Failed to get available languages: ${error.message}`);
-    return [];
-  }
-}
-
-/**
- * 检查资源是否已同步
- * @returns {Boolean} true表示资源已同步
- */
-export async function isResourcesSynced() {
-  try {
-    const cache = await readResourceCache();
-    return cache !== null;
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * 获取资源同步时间
- * @returns {String|null} ISO时间字符串
- */
-export async function getLastSyncTime() {
-  try {
-    const cache = await readResourceCache();
-    return cache ? cache.lastSync : null;
-  } catch (error) {
-    return null;
-  }
-}
-
-/**
- * 🟢 GREEN: 读取文件的前几行作为摘要
- * @param {string} filePath - 文件路径
- * @param {number} maxLines - 最多读取的行数
- * @returns {string} 摘要内容
- */
-async function readFileSummary(filePath, maxLines = 2) {
-  try {
-    const content = await fs.readFile(filePath, 'utf-8');
-    const allLines = content.split('\n');
-    
-    // 去掉markdown标题符号和空行，获取前N行有效内容
-    const validLines = allLines
-      .map(line => line.replace(/^#+\s*/, '').trim())
-      .filter(line => line.length > 0)
-      .slice(0, maxLines); // 取前N行有效内容
-    
-    // 每行限制120字符，用换行符连接
-    const summary = validLines
-      .map(line => line.substring(0, 120))
-      .join('\n  '); // 第二行缩进以便区分
-    
-    return summary || 'No description available';
-  } catch (error) {
-    return 'Description not available';
-  }
-}
-
-/**
- * 🟢 GREEN: 格式化resources列表为轻量级文本（供prompt使用）
- * @param {Array<string>} resourceTypes - 需要的resource类型 ['projects', 'rules']
- * @returns {string} 格式化的文本
- */
-export async function formatResourcesList(resourceTypes = ['projects', 'rules']) {
-  try {
-    const cache = await readResourceCache();
-    if (!cache) {
-      return '# Available Resources\n\n(No resources cached yet)\n';
-    }
-    
-    let text = '# Available Resources\n\n';
-    
-    // 格式化projects
-    if (resourceTypes.includes('projects') && cache.projects && cache.projects.length > 0) {
-      text += '## Projects Documentation\n';
-      for (const project of cache.projects) {
-        // 尝试读取文件摘要
-        const projectPath = path.join(CFG.cacheDir, 'projects', project.filename);
-        const summary = await readFileSummary(projectPath);
-        text += `- **${project.filename}**: ${summary}\n`;
-      }
-      text += '\n';
-    }
-    
-    // 格式化rules
-    if (resourceTypes.includes('rules') && cache.rules && cache.rules.length > 0) {
-      text += '## Rules & Standards\n';
-      for (const rule of cache.rules) {
-        // 尝试读取文件摘要
-        const rulePath = path.join(CFG.cacheDir, 'rules', rule.filename);
-        const summary = await readFileSummary(rulePath);
-        text += `- **${rule.filename}**: ${summary}\n`;
-      }
-      text += '\n';
-    }
-    
-    text += '---\n\n';
-    text += '*To load full content of a resource, use the `load-resource` tool when needed.*\n\n';
-    
-    return text;
-  } catch (error) {
-    console.error('[ResourceManager] Failed to format resources list:', error.message);
-    return '# Available Resources\n\n(Error loading resources)\n';
-  }
-}
-
-/**
- * 🟢 GREEN: 加载resource的完整内容
- * @param {string} resourceName - 资源名称（不含路径，如 "java-rules.md"）
- * @returns {Object} { success: boolean, content: string, error?: string }
- */
-export async function loadResourceContent(resourceName) {
-  try {
-    const cache = await readResourceCache();
-    if (!cache) {
-      return { success: false, error: 'No resources cached' };
-    }
-    
-    // 查找resource在哪个类型中
-    let resourcePath = null;
-    let resourceType = null;
-    
-    // 检查projects
-    if (cache.projects.some(p => p.filename === resourceName)) {
-      resourcePath = path.join(CFG.cacheDir, 'projects', resourceName);
-      resourceType = 'project';
-    }
-    // 检查rules
-    else if (cache.rules.some(r => r.filename === resourceName)) {
-      resourcePath = path.join(CFG.cacheDir, 'rules', resourceName);
-      resourceType = 'rule';
-    }
-    
-    if (!resourcePath) {
-      return { success: false, error: `Resource "${resourceName}" not found in cache` };
-    }
-    
-    // 读取文件内容
-    const content = await fs.readFile(resourcePath, 'utf-8');
-    return {
-      success: true,
-      content: content,
-      type: resourceType,
-      filename: resourceName
-    };
-  } catch (error) {
-    return { success: false, error: error.message };
-  }
-}
-
-/**
- * 获取资源统计信息
- * @returns {Object} 统计信息
- */
-export async function getResourceStats() {
-  try {
-    const cache = await readResourceCache();
-    
-    if (!cache) {
-      return {
-        synced: false,
-        prompts: 0,
-        projects: 0,
-        rules: 0,
-        total: 0,
-        lastSync: null
-      };
-    }
-    
-    return {
-      synced: true,
-      prompts: cache.prompts?.length || 0,
-      projects: cache.projects?.length || 0,
-      rules: cache.rules?.length || 0,
-      total: (cache.prompts?.length || 0) + (cache.projects?.length || 0) + (cache.rules?.length || 0),
-      lastSync: cache.lastSync
-    };
-  } catch (error) {
-    console.error(`[ResourceManager] Failed to get resource stats: ${error.message}`);
-    return {
-      synced: false,
-      prompts: 0,
-      projects: 0,
-      rules: 0,
-      total: 0,
-      lastSync: null
-    };
-  }
-}
-