autosnippet 3.2.9 → 3.2.11

package/lib/infrastructure/cache/UnifiedCacheAdapter.js

@@ -1,115 +0,0 @@
-/**
- * 统一缓存适配器
- * 内存缓存模式
- */
-
-import Logger from '../logging/Logger.js';
-import { cacheService as memoryCacheService } from './CacheService.js';
-
-export class UnifiedCacheAdapter {
-  constructor() {
-    this.mode = 'memory';
-    this.memoryService = memoryCacheService;
-  }
-
-  /**
-   * 初始化缓存服务
-   */
-  async initialize() {
-    Logger.info('✅ 内存缓存已启用');
-  }
-
-  /**
-   * 获取缓存值
-   */
-  async get(key) {
-    try {
-      return this.memoryService.get(key);
-    } catch (error) {
-      Logger.error(`缓存获取失败 (${key}):`, { error: error.message });
-      return null;
-    }
-  }
-
-  /**
-   * 设置缓存值
-   */
-  async set(key, value, ttlSeconds = 300) {
-    try {
-      this.memoryService.set(key, value, ttlSeconds);
-      return true;
-    } catch (error) {
-      Logger.error(`缓存设置失败 (${key}):`, { error: error.message });
-      return false;
-    }
-  }
-
-  /**
-   * 删除缓存
-   */
-  async delete(key) {
-    try {
-      return this.memoryService.delete(key);
-    } catch (error) {
-      Logger.error(`缓存删除失败 (${key}):`, { error: error.message });
-      return false;
-    }
-  }
-
-  /**
-   * 清空所有缓存
-   */
-  async clear() {
-    try {
-      this.memoryService.clear();
-      return true;
-    } catch (error) {
-      Logger.error('缓存清空失败:', { error: error.message });
-      return false;
-    }
-  }
-
-  /**
-   * 获取统计信息
-   */
-  getStats() {
-    const stats = this.memoryService.getStats();
-    return { mode: 'memory', available: true, ...stats };
-  }
-
-  /**
-   * 健康检查
-   */
-  async healthCheck() {
-    return { healthy: true, mode: 'memory', message: '内存缓存运行正常' };
-  }
-}
-
-// 单例实例
-let cacheAdapterInstance = null;
-
-/**
- * 初始化统一缓存适配器
- */
-export async function initCacheAdapter() {
-  if (cacheAdapterInstance) {
-    Logger.warn('缓存适配器已初始化');
-    return cacheAdapterInstance;
-  }
-
-  cacheAdapterInstance = new UnifiedCacheAdapter();
-  await cacheAdapterInstance.initialize();
-  return cacheAdapterInstance;
-}
-
-/**
- * 获取缓存适配器实例
- */
-export function getCacheAdapter() {
-  if (!cacheAdapterInstance) {
-    throw new Error('缓存适配器未初始化，请先调用 initCacheAdapter()');
-  }
-  return cacheAdapterInstance;
-}
-
-export default UnifiedCacheAdapter;

package/lib/infrastructure/config/ConfigLoader.js

@@ -1,114 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * ConfigLoader - 配置加载器
- * 直接读取 JSON 配置文件，避免 node-config 模块在 import 阶段就读取配置目录的时序问题
- */
-export class ConfigLoader {
-  static instance = null;
-  static config = null;
-
-  static load(env = process.env.NODE_ENV || 'development') {
-    if (!this.config) {
-      const configDir = path.join(__dirname, '../../../config');
-
-      // 加载默认配置
-      const defaultPath = path.join(configDir, 'default.json');
-      let merged = {};
-      if (fs.existsSync(defaultPath)) {
-        merged = JSON.parse(fs.readFileSync(defaultPath, 'utf8'));
-      }
-
-      // 加载环境专用配置（覆盖默认）
-      const envPath = path.join(configDir, `${env}.json`);
-      if (fs.existsSync(envPath)) {
-        const envConfig = JSON.parse(fs.readFileSync(envPath, 'utf8'));
-        merged = this._deepMerge(merged, envConfig);
-      }
-
-      // 加载 local 配置（开发者覆盖，不入版本控制）
-      const localPath = path.join(configDir, 'local.json');
-      if (fs.existsSync(localPath)) {
-        const localConfig = JSON.parse(fs.readFileSync(localPath, 'utf8'));
-        merged = this._deepMerge(merged, localConfig);
-      }
-
-      merged.env = env;
-      this.config = merged;
-    }
-
-    return this.config;
-  }
-
-  static _deepMerge(target, source) {
-    const output = { ...target };
-    for (const key of Object.keys(source)) {
-      if (
-        source[key] &&
-        typeof source[key] === 'object' &&
-        !Array.isArray(source[key]) &&
-        target[key] &&
-        typeof target[key] === 'object' &&
-        !Array.isArray(target[key])
-      ) {
-        output[key] = this._deepMerge(target[key], source[key]);
-      } else {
-        output[key] = source[key];
-      }
-    }
-    return output;
-  }
-
-  static get(key) {
-    if (!this.config) {
-      this.load();
-    }
-
-    const keys = key.split('.');
-    let value = this.config;
-
-    for (const k of keys) {
-      value = value?.[k];
-      if (value === undefined) {
-        throw new Error(`Config key not found: ${key}`);
-      }
-    }
-
-    return value;
-  }
-
-  static has(key) {
-    try {
-      this.get(key);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  static set(key, value) {
-    if (!this.config) {
-      this.load();
-    }
-
-    const keys = key.split('.');
-    let obj = this.config;
-
-    for (let i = 0; i < keys.length - 1; i++) {
-      const k = keys[i];
-      if (!obj[k]) {
-        obj[k] = {};
-      }
-      obj = obj[k];
-    }
-
-    obj[keys[keys.length - 1]] = value;
-  }
-}
-
-export default ConfigLoader;

package/lib/infrastructure/config/Defaults.js

@@ -1,92 +0,0 @@
-/**
- * Defaults — 项目级默认常量与配置
- * 统一管理路径名、存储适配器、索引策略、分类规则等默认值
- */
-
-// ─── 路径 ────────────────────────────────────────────────────
-export const SPEC_FILENAME = 'AutoSnippet.boxspec.json';
-export const KNOWLEDGE_BASE_DIR = 'AutoSnippet';
-export const RECIPES_DIR = 'AutoSnippet/recipes';
-export const CANDIDATES_DIR = 'AutoSnippet/candidates';
-export const RECIPES_INDEX = 'AutoSnippet/recipes/index.json';
-export const SPMMAP_FILENAME = 'AutoSnippet.spmmap.json';
-export const SPMMAP_PATH = `AutoSnippet/${SPMMAP_FILENAME}`;
-
-// ─── Context 存储 ────────────────────────────────────────────
-export const DEFAULT_STORAGE_ADAPTER = 'json';
-export const STORAGE_ADAPTERS = ['json'];
-
-// ─── Context 索引 ────────────────────────────────────────────
-export const SOURCE_TYPES = ['recipe', 'doc', 'target-readme'];
-export const SOURCE_TYPE_RECIPE = 'recipe';
-export const SOURCE_TYPE_TARGET_README = 'target-readme';
-export const DEFAULT_SOURCES = [{ path: RECIPES_DIR, type: 'recipe' }];
-export const DEFAULT_CHUNKING = { strategy: 'whole' };
-export const CHUNKING_STRATEGIES = ['whole', 'section', 'fixed', 'auto'];
-export const DEFAULT_MAX_CHUNK_TOKENS = 800;
-export const DEFAULT_OVERLAP_TOKENS = 80;
-export const CHARS_PER_TOKEN = 3;
-
-// ─── Target README ───────────────────────────────────────────
-export const README_NAMES = ['README.md', 'README_CN.md', 'readme.md'];
-
-// ─── MCP / 连接层 ───────────────────────────────────────────
-export const DEFAULT_ASD_UI_URL = 'http://localhost:3000';
-
-// ─── Guard ───────────────────────────────────────────────────
-export const GUARD_CONTEXT_EXCERPT_LIMIT = 12000;
-
-// ─── Skills / Category ──────────────────────────────────────
-export const CATEGORY_RULES = [
-  { pattern: /network|net|请求|api/i, category: 'network' },
-  { pattern: /video|播放|player/i, category: 'video' },
-  { pattern: /scheme|url|跳转|router/i, category: 'navigation' },
-  { pattern: /pyramid|service|服务/i, category: 'foundation' },
-  { pattern: /ui|view|cell|table/i, category: 'ui' },
-];
-export const DEFAULT_CATEGORY = 'general';
-
-/**
- * 从文件路径和内容推断 category
- * 优先读取 frontmatter 的 category 字段，其次匹配路径规则
- */
-export function inferCategory(relPath, content) {
-  const frontMatch = (content || '').match(/^---[\s\S]*?category:\s*["']?([\w-]+)["']?/m);
-  if (frontMatch) {
-    return frontMatch[1];
-  }
-  const lower = (relPath || '').toLowerCase();
-  for (const { pattern, category } of CATEGORY_RULES) {
-    if (pattern.test(lower)) {
-      return category;
-    }
-  }
-  return DEFAULT_CATEGORY;
-}
-
-export default {
-  SPEC_FILENAME,
-  KNOWLEDGE_BASE_DIR,
-  RECIPES_DIR,
-  CANDIDATES_DIR,
-  RECIPES_INDEX,
-  SPMMAP_FILENAME,
-  SPMMAP_PATH,
-  DEFAULT_STORAGE_ADAPTER,
-  STORAGE_ADAPTERS,
-  SOURCE_TYPES,
-  SOURCE_TYPE_RECIPE,
-  SOURCE_TYPE_TARGET_README,
-  DEFAULT_SOURCES,
-  DEFAULT_CHUNKING,
-  CHUNKING_STRATEGIES,
-  DEFAULT_MAX_CHUNK_TOKENS,
-  DEFAULT_OVERLAP_TOKENS,
-  CHARS_PER_TOKEN,
-  README_NAMES,
-  DEFAULT_ASD_UI_URL,
-  GUARD_CONTEXT_EXCERPT_LIMIT,
-  CATEGORY_RULES,
-  DEFAULT_CATEGORY,
-  inferCategory,
-};

package/lib/infrastructure/config/Paths.js

@@ -1,167 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import pathGuard from '../../shared/PathGuard.js';
-
-/**
- * Paths — 项目路径解析工具
- * 提供 Snippet 安装目录、缓存目录、知识库目录等路径计算能力。
- *
- * 设计原则：路径解析与目录创建分离
- *  - 路径 getter 函数仅返回路径字符串，不产生文件系统副作用
- *  - 需要创建目录时，调用方应使用 ensureDir() 显式确保目录存在
- *  - 全局非项目目录（Xcode snippets、cache）在获取时自动创建
- */
-
-export const SPEC_FILENAME = 'AutoSnippet.boxspec.json';
-
-const USER_HOME = process.env.HOME || process.env.USERPROFILE || '';
-
-/** 确保目录存在（静默处理异常），供写入前调用 */
-export function ensureDir(dirPath) {
-  try {
-    // 双层路径安全检查 — 阻止在项目允许范围外创建文件夹
-    pathGuard.assertProjectWriteSafe(dirPath);
-    if (!fs.existsSync(dirPath)) {
-      fs.mkdirSync(dirPath, { recursive: true });
-    }
-  } catch {
-    /* ignore */
-  }
-  return dirPath;
-}
-
-/**
- * Xcode CodeSnippets 输出目录 (macOS only)
- * 可通过 ASD_SNIPPETS_PATH 环境变量覆盖
- * 非 macOS 返回全局缓存下的 snippets/ 子目录
- */
-export function getSnippetsPath() {
-  if (process.env.ASD_SNIPPETS_PATH) {
-    return process.env.ASD_SNIPPETS_PATH;
-  }
-  if (process.platform === 'darwin') {
-    return ensureDir(path.join(USER_HOME, 'Library/Developer/Xcode/UserData/CodeSnippets'));
-  }
-  // 非 macOS: 放到全局缓存目录下
-  return ensureDir(path.join(USER_HOME, '.autosnippet', 'snippets'));
-}
-
-/**
- * VSCode 项目级 Snippets 目录 = projectRoot/.vscode/
- * @param {string} projectRoot
- * @returns {string}
- */
-export function getVSCodeSnippetsPath(projectRoot) {
-  return ensureDir(path.join(projectRoot, '.vscode'));
-}
-
-/**
- * AutoSnippet 全局缓存目录 ~/.autosnippet/cache
- * 可通过 ASD_CACHE_PATH 环境变量覆盖
- */
-export function getCachePath() {
-  if (process.env.ASD_CACHE_PATH) {
-    return process.env.ASD_CACHE_PATH;
-  }
-  return ensureDir(path.join(USER_HOME, '.autosnippet', 'cache'));
-}
-
-/**
- * 获取包含 AutoSnippet.boxspec.json 的子目录名称
- * 遍历 projectRoot 一级子目录，找到含 spec 文件的目录
- * @param {string} projectRoot
- * @returns {string} 知识库目录名（默认 'AutoSnippet'）
- */
-export function getKnowledgeBaseDirName(projectRoot) {
-  try {
-    const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
-    for (const e of entries) {
-      if (e.isDirectory() && !e.name.startsWith('.')) {
-        if (fs.existsSync(path.join(projectRoot, e.name, SPEC_FILENAME))) {
-          return e.name;
-        }
-      }
-    }
-  } catch {
-    /* ignore */
-  }
-  return 'AutoSnippet';
-}
-
-/**
- * 知识库根目录 = projectRoot/{dirContainingBoxspec}
- * 注意：仅返回路径，不创建目录
- */
-export function getProjectKnowledgePath(projectRoot) {
-  return path.join(projectRoot, getKnowledgeBaseDirName(projectRoot));
-}
-
-/**
- * Spec 文件路径 = knowledgePath/AutoSnippet.boxspec.json
- */
-export function getProjectSpecPath(projectRoot) {
-  return path.join(getProjectKnowledgePath(projectRoot), SPEC_FILENAME);
-}
-
-/**
- * 项目内部隐藏数据目录 = knowledgePath/.autosnippet
- * 注意：仅返回路径，不创建目录
- */
-export function getProjectInternalDataPath(projectRoot) {
-  return path.join(getProjectKnowledgePath(projectRoot), '.autosnippet');
-}
-
-/**
- * 上下文存储目录 = internalData/context
- * 注意：仅返回路径，不创建目录
- */
-export function getContextStoragePath(projectRoot) {
-  return path.join(getProjectInternalDataPath(projectRoot), 'context');
-}
-
-/**
- * 上下文索引目录 = contextStorage/index
- * 注意：仅返回路径，不创建目录
- */
-export function getContextIndexPath(projectRoot) {
-  return path.join(getContextStoragePath(projectRoot), 'index');
-}
-
-/**
- * 项目级 Skills 目录 = knowledgePath/skills
- * Skills 放在知识库目录下跟随项目走（Git-tracked，用户可见）
- * 注意：仅返回路径，不创建目录
- */
-export function getProjectSkillsPath(projectRoot) {
-  return path.join(getProjectKnowledgePath(projectRoot), 'skills');
-}
-
-/**
- * Recipes 目录
- * 优先使用 rootSpec.recipes.dir / rootSpec.skills.dir（兼容旧配置）
- * @param {string} projectRoot
- * @param {object} [rootSpec] - 项目 spec 对象（可选）
- */
-export function getProjectRecipesPath(projectRoot, rootSpec) {
-  const dir = rootSpec?.recipes?.dir || rootSpec?.skills?.dir || null;
-  if (dir) {
-    return path.join(projectRoot, dir);
-  }
-  return path.join(getProjectKnowledgePath(projectRoot), 'recipes');
-}
-
-export default {
-  SPEC_FILENAME,
-  ensureDir,
-  getSnippetsPath,
-  getVSCodeSnippetsPath,
-  getCachePath,
-  getKnowledgeBaseDirName,
-  getProjectKnowledgePath,
-  getProjectSpecPath,
-  getProjectInternalDataPath,
-  getProjectSkillsPath,
-  getContextStoragePath,
-  getContextIndexPath,
-  getProjectRecipesPath,
-};

package/lib/infrastructure/config/TriggerSymbol.js

@@ -1,76 +0,0 @@
-/**
- * TriggerSymbol - Snippet 触发符配置
- *
- * 默认使用 @，可通过环境变量 ASD_TRIGGER_SYMBOL 覆盖（单字符）。
- * V2 ESM 版本，对应 V1 TriggerSymbol.js
- */
-
-const DEFAULT_SYMBOL = '@';
-
-function fromEnv() {
-  const raw = process.env.ASD_TRIGGER_SYMBOL;
-  if (raw != null && String(raw).length === 1) {
-    return String(raw);
-  }
-  return DEFAULT_SYMBOL;
-}
-
-function escapeRegExp(s) {
-  return s.replace(/[\\^$*+?.()|[\]{}]/g, '\\$&');
-}
-
-/** 当前触发符（可配置） */
-export const TRIGGER_SYMBOL = fromEnv();
-
-/** 用于拆分的触发符集合 */
-export const TRIGGER_SYMBOLS = [TRIGGER_SYMBOL];
-
-/** 用于按触发符拆分的正则 */
-export const TRIGGER_SPLIT_REGEX = new RegExp(`[${TRIGGER_SYMBOLS.map(escapeRegExp).join('')}]`);
-
-/** str 是否以触发符开头 */
-export function hasTriggerPrefix(str) {
-  if (!str || typeof str !== 'string') {
-    return false;
-  }
-  const s = String(str).trim();
-  return TRIGGER_SYMBOLS.some((sym) => s.startsWith(sym));
-}
-
-/** 去掉 str 开头的连续触发符 */
-export function stripTriggerPrefix(str) {
-  if (!str || typeof str !== 'string') {
-    return String(str);
-  }
-  let s = String(str).trim();
-  while (s.length && TRIGGER_SYMBOLS.some((sym) => s.startsWith(sym))) {
-    s = s.slice(1).trimStart();
-  }
-  return s;
-}
-
-/** 若 str 不以触发符开头，则加上默认触发符 */
-export function ensureTriggerPrefix(str) {
-  if (!str || typeof str !== 'string') {
-    return str;
-  }
-  const s = String(str).trim();
-  if (!s) {
-    return s;
-  }
-  return hasTriggerPrefix(s) ? s : TRIGGER_SYMBOL + s;
-}
-
-/** 获取 str 已带的触发符，否则返回默认触发符 */
-export function getPrefixFromTrigger(str) {
-  if (!str || typeof str !== 'string') {
-    return TRIGGER_SYMBOL;
-  }
-  const s = String(str).trim();
-  for (const sym of TRIGGER_SYMBOLS) {
-    if (s.startsWith(sym)) {
-      return sym;
-    }
-  }
-  return TRIGGER_SYMBOL;
-}

package/lib/infrastructure/database/DatabaseConnection.js

@@ -1,137 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import Database from 'better-sqlite3';
-import pathGuard from '../../shared/PathGuard.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * DatabaseConnection - 数据库连接管理器
- *
- * 重要：相对 DB 路径通过 projectRoot 解析，而非 process.cwd()。
- * 这样即使 MCP 服务器的 cwd 不是项目目录，DB 也不会创建到项目外。
- */
-export class DatabaseConnection {
-  constructor(config) {
-    this.config = config;
-    this.db = null;
-  }
-
-  /**
-   * 连接数据库
-   */
-  async connect() {
-    const dbPath = this.config.path;
-
-    // 使用 projectRoot（PathGuard 已配置）优先解析相对路径，
-    // 而非 path.resolve()（依赖 cwd，MCP 场景下 cwd 可能是用户主目录）
-    const projectRoot = pathGuard.projectRoot;
-    const resolvedDbPath =
-      projectRoot && !path.isAbsolute(dbPath)
-        ? path.resolve(projectRoot, dbPath)
-        : path.resolve(dbPath);
-
-    // 路径安全检查 — 防止 DB 文件创建到项目允许范围外
-    pathGuard.assertProjectWriteSafe(resolvedDbPath);
-
-    // 确保数据目录存在
-    const dbDir = path.dirname(resolvedDbPath);
-    if (!fs.existsSync(dbDir)) {
-      fs.mkdirSync(dbDir, { recursive: true });
-    }
-
-    this.db = new Database(resolvedDbPath, {
-      verbose: this.config.verbose ? (msg) => process.stderr.write(`[SQL] ${msg}\n`) : null,
-    });
-
-    // 启用 WAL 模式（Write-Ahead Logging）
-    this.db.pragma('journal_mode = WAL');
-    this.db.pragma('foreign_keys = ON');
-
-    return this.db;
-  }
-
-  /**
-   * 运行所有 migration（支持 .sql 和 .js）
-   */
-  async runMigrations() {
-    const migrationsDir = path.join(__dirname, 'migrations');
-    const migrationFiles = fs
-      .readdirSync(migrationsDir)
-      .filter((file) => file.endsWith('.sql') || file.endsWith('.js'))
-      .sort();
-
-    // 确保 schema_migrations 表存在
-    this.db.exec(`
-      CREATE TABLE IF NOT EXISTS schema_migrations (
-        version TEXT PRIMARY KEY,
-        applied_at TEXT NOT NULL
-      )
-    `);
-
-    for (const file of migrationFiles) {
-      const version = file.replace(/\.(sql|js)$/, '');
-
-      // 检查是否已应用
-      const applied = this.db
-        .prepare('SELECT version FROM schema_migrations WHERE version = ?')
-        .get(version);
-
-      if (!applied) {
-        process.stderr.write(`Applying migration: ${version}\n`);
-
-        if (file.endsWith('.js')) {
-          // JS migration: export default function(db) { ... }
-          const mod = await import(path.join(migrationsDir, file));
-          const migrate = mod.default || mod;
-          const runMigration = this.db.transaction(() => {
-            migrate(this.db);
-            this.db
-              .prepare(
-                'INSERT OR IGNORE INTO schema_migrations (version, applied_at) VALUES (?, ?)'
-              )
-              .run(version, new Date().toISOString());
-          });
-          runMigration();
-        } else {
-          const sql = fs.readFileSync(path.join(migrationsDir, file), 'utf8');
-          const runMigration = this.db.transaction(() => {
-            this.db.exec(sql);
-            this.db
-              .prepare(
-                'INSERT OR IGNORE INTO schema_migrations (version, applied_at) VALUES (?, ?)'
-              )
-              .run(version, new Date().toISOString());
-          });
-          runMigration();
-        }
-
-        process.stderr.write(`✅ Migration ${version} applied\n`);
-      }
-    }
-  }
-
-  /**
-   * 关闭数据库连接
-   */
-  close() {
-    if (this.db) {
-      this.db.close();
-      this.db = null;
-    }
-  }
-
-  /**
-   * 获取数据库实例
-   */
-  getDb() {
-    if (!this.db) {
-      throw new Error('Database not connected. Call connect() first.');
-    }
-    return this.db;
-  }
-}
-
-export default DatabaseConnection;