autosnippet 3.2.9 → 3.2.11

package/lib/service/cursor/FileProtection.js

@@ -1,119 +0,0 @@
-/**
- * FileProtection — 非 AutoSnippet 独有文件的写入保护
- *
- * 保护逻辑：
- *   - 如果目标文件不存在 → 直接写入（首次生成）
- *   - 如果目标文件存在且包含 AutoSnippet 签名 → 允许覆盖（我们生成的）
- *   - 如果目标文件存在但不包含 AutoSnippet 签名 → 拒绝覆盖（用户原有文件）
- *
- * 签名标记（任意一个匹配即视为 AutoSnippet 所有）：
- *   - "Auto-generated by AutoSnippet"
- *   - "Auto-generated by [AutoSnippet]"
- *   - "auto-generated by autosnippet" (case-insensitive)
- */
-
-import fs from 'node:fs';
-
-/**
- * AutoSnippet 文件签名模式（case-insensitive）
- * 检查文件前 1024 字节即可——签名总在文件头部
- * 匹配以下任一标记：
- *   - "Auto-generated by AutoSnippet" / "Auto-generated by [AutoSnippet]"
- *   - "<!-- autosnippet:begin -->" (模板起始标记)
- */
-const SIGNATURE_PATTERN = /auto-generated by (?:\[)?autosnippet(?:\])?|autosnippet:begin/i;
-
-/**
- * 检查文件是否可以被 AutoSnippet 安全写入
- *
- * @param {string} filePath - 目标文件绝对路径
- * @returns {{ canWrite: boolean, reason: string }}
- *   - canWrite: true  → 可以安全写入
- *   - canWrite: false → 文件存在且非 AutoSnippet 生成，不应覆盖
- */
-export function checkWriteSafety(filePath) {
-  if (!fs.existsSync(filePath)) {
-    return { canWrite: true, reason: 'file-not-exist' };
-  }
-
-  try {
-    // 只读前 1024 字节检测签名，避免大文件全量读取
-    const fd = fs.openSync(filePath, 'r');
-    const buf = Buffer.alloc(1024);
-    const bytesRead = fs.readSync(fd, buf, 0, 1024, 0);
-    fs.closeSync(fd);
-
-    const header = buf.toString('utf8', 0, bytesRead);
-    if (SIGNATURE_PATTERN.test(header)) {
-      return { canWrite: true, reason: 'autosnippet-owned' };
-    }
-
-    return { canWrite: false, reason: 'user-owned' };
-  } catch {
-    // 读取失败（权限等问题），保守处理：不覆盖
-    return { canWrite: false, reason: 'read-error' };
-  }
-}
-
-/**
- * 安全写入文件 — 带保护机制
- *
- * @param {string} filePath - 目标文件绝对路径
- * @param {string} content - 文件内容
- * @param {Object} [options]
- * @param {boolean} [options.force=false] - 强制覆盖（忽略保护）
- * @param {Object} [options.logger] - 日志器
- * @returns {{ written: boolean, reason: string, filePath: string }}
- */
-export function safeWriteFile(filePath, content, options = {}) {
-  const { force = false, logger } = options;
-
-  if (force) {
-    fs.writeFileSync(filePath, content, 'utf8');
-    return { written: true, reason: 'force', filePath };
-  }
-
-  const { canWrite, reason } = checkWriteSafety(filePath);
-
-  if (canWrite) {
-    fs.writeFileSync(filePath, content, 'utf8');
-    return { written: true, reason, filePath };
-  }
-
-  // 用户原有文件 → 跳过
-  logger?.info?.(
-    `[FileProtection] Skipped "${filePath}" — ${reason} (file exists and is not AutoSnippet-generated)`
-  );
-  return { written: false, reason, filePath };
-}
-
-/**
- * 安全复制文件 — 带保护机制
- *
- * @param {string} srcPath - 源文件路径
- * @param {string} destPath - 目标文件路径
- * @param {Object} [options]
- * @param {boolean} [options.force=false] - 强制覆盖
- * @param {Object} [options.logger] - 日志器
- * @returns {{ written: boolean, reason: string, filePath: string }}
- */
-export function safeCopyFile(srcPath, destPath, options = {}) {
-  const { force = false, logger } = options;
-
-  if (force) {
-    fs.copyFileSync(srcPath, destPath);
-    return { written: true, reason: 'force', filePath: destPath };
-  }
-
-  const { canWrite, reason } = checkWriteSafety(destPath);
-
-  if (canWrite) {
-    fs.copyFileSync(srcPath, destPath);
-    return { written: true, reason, filePath: destPath };
-  }
-
-  logger?.info?.(
-    `[FileProtection] Skipped "${destPath}" — ${reason} (file exists and is not AutoSnippet-generated)`
-  );
-  return { written: false, reason, filePath: destPath };
-}

package/lib/service/cursor/KnowledgeCompressor.js

@@ -1,189 +0,0 @@
-/**
- * KnowledgeCompressor — 知识条目压缩器（v3 优化版）
- *
- * 将 KnowledgeEntry（含 AI 预计算字段）格式化为 Cursor 交付格式：
- *   - Channel A: compressToRuleLine() → 一行式强制规则（含可选 language 前缀）
- *   - Channel B: compressToWhenDoDont() → When/Do/Don't/Why + Template 格式
- *
- * 原则：只做格式化，无字段 = 不输出，不做启发式猜测。
- *
- * v3 变更:
- *   - Channel A: 多语言项目中增加 [language] 前缀
- *   - Channel B: 增加 Why 行（content.rationale 首句）
- *   - Channel B: coreCode 骨架化（去注释 + 截断 ≤15 行）
- */
-
-/** 从 rationale 提取首句（≤120 字符），用于 Channel B 的 Why 行 */
-function _extractFirstSentence(rationale) {
-  if (!rationale) {
-    return '';
-  }
-  // 优先按句号或换行分割
-  const first = rationale.split(/[.\n。！？!?]/)[0]?.trim();
-  if (!first) {
-    return '';
-  }
-  return first.length > 120 ? `${first.slice(0, 117)}...` : first;
-}
-
-/** 骨架化 coreCode：去注释 + 截断 ≤ maxLines 行 */
-function _skeletonize(code, maxLines = 15) {
-  if (!code) {
-    return '';
-  }
-  const lines = code
-    .split('\n')
-    // 去掉纯注释行（// 或 /* 或 * (JSDoc续行) 或 # 开头）
-    .filter((l) => !/^\s*(\/\/|\/\*|\*\s|#\s)/.test(l))
-    // 去掉空行连续超过 1 行
-    .reduce((acc, line) => {
-      if (line.trim() === '' && acc.length > 0 && acc[acc.length - 1].trim() === '') {
-        return acc; // 跳过连续空行
-      }
-      acc.push(line);
-      return acc;
-    }, []);
-  if (lines.length <= maxLines) {
-    return lines.join('\n');
-  }
-  return `${lines.slice(0, maxLines).join('\n')}\n// ... (truncated)`;
-}
-
-export class KnowledgeCompressor {
-  /**
-   * Channel A — 一行式规则（含可选 language 前缀）
-   *
-   * 多语言项目中增加 [language] 前缀，帮助 Agent 判断规则适用性。
-   * scope='universal' 或无 language 的规则不加前缀。
-   *
-   * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='rule')
-   * @returns {Array<string>}
-   */
-  compressToRuleLine(entries) {
-    return entries
-      .filter((e) => e.doClause) // 无 doClause → 跳过，不猜
-      .map((e) => {
-        // 可选 language 前缀
-        const langPrefix = e.language && e.scope !== 'universal' ? `[${e.language}] ` : '';
-        const doText = e.doClause.replace(/\.+$/, ''); // 去尾 .
-        let line = `${langPrefix}${doText}`;
-        if (e.dontClause) {
-          // AI 可能返回 "Don't ..." / "Do not ..." / "Never ..." 开头，去掉冗余前缀后统一为 "Do NOT"
-          const stripped = e.dontClause
-            .replace(/^(Don't|Do not|Never)\s+/i, '')
-            .replace(/\.+$/, '');
-          line += `. Do NOT ${stripped}`;
-        }
-        return `- ${line}.`;
-      });
-  }
-
-  /**
-   * Channel B — When/Do/Don't/Why + Template（骨架化）
-   * @param {Array<Object>} entries - KnowledgeEntry 数组 (kind='pattern')
-   * @returns {Array<{ trigger: string, when: string, do: string, dont: string, why: string, template: string }>}
-   */
-  compressToWhenDoDont(entries) {
-    const seen = new Set();
-    return entries
-      .filter((e) => e.trigger && e.whenClause && e.doClause) // 缺任一 → 跳过
-      .map((e) => {
-        let trigger = e.trigger.startsWith('@') ? e.trigger : `@${e.trigger}`;
-        // trigger 去重（AI 应保证唯一，但防御性检查）
-        if (seen.has(trigger)) {
-          let i = 2;
-          while (seen.has(`${trigger}-${i}`)) {
-            i++;
-          }
-          trigger = `${trigger}-${i}`;
-        }
-        seen.add(trigger);
-
-        // 提取 rationale 首句作 Why 行
-        const rationale = e.content?.rationale || '';
-        const why = _extractFirstSentence(rationale);
-
-        return {
-          trigger,
-          when: e.whenClause,
-          do: e.doClause,
-          dont: e.dontClause || '',
-          why,
-          template: _skeletonize(e.coreCode),
-        };
-      });
-  }
-
-  /**
-   * 将 When/Do/Don't/Why 结果格式化为 Markdown 字符串
-   * @param {Array<Object>} compressed - compressToWhenDoDont 输出
-   * @param {string} [language=''] - 代码围栏语言标识
-   * @returns {string}
-   */
-  formatWhenDoDont(compressed, language = '') {
-    const lang = language || '';
-    return compressed
-      .map((item) => {
-        const lines = [`### ${item.trigger}`];
-        lines.push(`- **When**: ${item.when}`);
-        lines.push(`- **Do**: ${item.do}`);
-        if (item.dont) {
-          const stripped = item.dont.replace(/^(Don't|Do not|Never)\s+/i, '');
-          lines.push(`- **Don't**: ${stripped}`);
-        }
-        if (item.why) {
-          lines.push(`- **Why**: ${item.why}`);
-        }
-        if (item.template) {
-          lines.push('');
-          lines.push(`\`\`\`${lang}`);
-          lines.push(item.template);
-          lines.push('```');
-        }
-        return lines.join('\n');
-      })
-      .join('\n\n');
-  }
-
-  /**
-   * Channel B — Fact 条目压缩为 "Know" 行
-   *
-   * fact 类型没有 trigger/whenClause/doClause 结构，
-   * 采用 "Know: {title} — {description}" 的简洁格式，
-   * 让 Agent 获取项目事实性知识（技术选型、架构决策等）。
-   *
-   * @param {Array<Object>} facts - KnowledgeEntry 数组 (kind='fact')
-   * @returns {Array<{ title: string, summary: string }>}
-   */
-  compressToFactLines(facts) {
-    return facts
-      .filter((e) => e.title)
-      .map((e) => {
-        const summary = e.description || e.content?.markdown || '';
-        const shortSummary = summary.length > 150
-          ? `${summary.slice(0, 147)}...`
-          : summary;
-        return { title: e.title, summary: shortSummary };
-      });
-  }
-
-  /**
-   * 将 Fact 压缩结果格式化为 Markdown 字符串
-   * @param {Array<{ title: string, summary: string }>} factLines
-   * @returns {string}
-   */
-  formatFactLines(factLines) {
-    if (factLines.length === 0) return '';
-    const lines = ['', '## Context Facts', ''];
-    for (const f of factLines) {
-      if (f.summary) {
-        lines.push(`- **${f.title}**: ${f.summary}`);
-      } else {
-        lines.push(`- **${f.title}**`);
-      }
-    }
-    return lines.join('\n');
-  }
-}
-
-export default KnowledgeCompressor;

package/lib/service/cursor/RulesGenerator.js

@@ -1,174 +0,0 @@
-/**
- * RulesGenerator — .mdc 文件生成器
- *
- * 生成 Cursor Rules 格式的 .mdc 文件到 .cursor/rules/ 目录：
- *   - Channel A: autosnippet-project-rules.mdc (alwaysApply: true)
- *   - Channel B: autosnippet-patterns-{topic}.mdc (alwaysApply: false)
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { BUDGET, estimateTokens } from './TokenBudget.js';
-
-export class RulesGenerator {
-  /**
-   * @param {string} projectRoot - 用户项目根目录
-   * @param {string} projectName - 项目名称（用于 description/标题）
-   */
-  constructor(projectRoot, projectName = 'Project') {
-    this.projectRoot = projectRoot;
-    this.projectName = projectName;
-    this.rulesDir = path.join(projectRoot, '.cursor', 'rules');
-  }
-
-  /**
-   * Channel A — 写入 Always-On Rules 文件
-   *
-   * @param {string[]} ruleLines - 一行式规则列表 (来自 KnowledgeCompressor.compressToRuleLine)
-   * @returns {{ filePath: string, tokensUsed: number, rulesCount: number }}
-   */
-  writeAlwaysOnRules(ruleLines) {
-    this._ensureDir();
-
-    // Token 预算控制
-    const kept = [];
-    let tokens = 0;
-    const headerFooterBudget = 100;
-    const ruleBudget = BUDGET.CHANNEL_A_MAX - headerFooterBudget;
-
-    for (const line of ruleLines) {
-      const lineTokens = estimateTokens(line);
-      if (tokens + lineTokens <= ruleBudget && kept.length < BUDGET.CHANNEL_A_MAX_RULES) {
-        kept.push(line);
-        tokens += lineTokens;
-      }
-    }
-
-    const content = this._renderChannelA(kept);
-    const filePath = path.join(this.rulesDir, 'autosnippet-project-rules.mdc');
-    fs.writeFileSync(filePath, content, 'utf8');
-
-    return {
-      filePath,
-      tokensUsed: estimateTokens(content),
-      rulesCount: kept.length,
-    };
-  }
-
-  /**
-   * Channel B — 写入 Smart Rules 文件（按主题）
-   *
-   * @param {string} topic - 主题名 (networking, ui, data, architecture, conventions, general)
-   * @param {string} compressedContent - 格式化后的 When/Do/Don't Markdown 内容
-   * @param {string} description - Agent 关联性判断用 description
-   * @returns {{ filePath: string, tokensUsed: number }}
-   */
-  writeSmartRules(topic, compressedContent, description) {
-    this._ensureDir();
-
-    // Token 预算控制
-    let body = compressedContent;
-    const totalTokens = estimateTokens(body) + estimateTokens(description) + 50;
-    if (totalTokens > BUDGET.CHANNEL_B_MAX_PER_FILE) {
-      // 截断尾部
-      const lines = body.split('\n');
-      const truncated = [];
-      let used = estimateTokens(description) + 50;
-      for (const line of lines) {
-        used += estimateTokens(`${line}\n`);
-        if (used <= BUDGET.CHANNEL_B_MAX_PER_FILE) {
-          truncated.push(line);
-        }
-      }
-      body = truncated.join('\n');
-    }
-
-    const content = this._renderChannelB(topic, body, description);
-    const fileName = `autosnippet-patterns-${topic}.mdc`;
-    const filePath = path.join(this.rulesDir, fileName);
-    fs.writeFileSync(filePath, content, 'utf8');
-
-    return {
-      filePath,
-      tokensUsed: estimateTokens(content),
-    };
-  }
-
-  /**
-   * 清理旧的动态生成文件
-   * 保留静态模板文件（autosnippet-conventions.mdc, autosnippet-skills.mdc）
-   */
-  cleanDynamicFiles() {
-    if (!fs.existsSync(this.rulesDir)) {
-      return;
-    }
-
-    const dynamicPrefixes = ['autosnippet-project-rules', 'autosnippet-patterns-'];
-    const files = fs.readdirSync(this.rulesDir);
-    for (const file of files) {
-      if (dynamicPrefixes.some((p) => file.startsWith(p))) {
-        const filePath = path.join(this.rulesDir, file);
-        try {
-          fs.unlinkSync(filePath);
-        } catch {
-          /* ignore */
-        }
-      }
-    }
-  }
-
-  // ─── 渲染方法 ───────────────────────────────────────
-
-  /**
-   * @private
-   */
-  _renderChannelA(ruleLines) {
-    const desc = `${this.projectName} mandatory rules — coding constraints that must never be violated. Auto-generated by AutoSnippet.`;
-    const lines = [
-      '---',
-      `description: "${desc}"`,
-      'alwaysApply: true',
-      '---',
-      '',
-      `# ${this.projectName} — Mandatory Rules`,
-      '',
-      ...ruleLines,
-      '',
-      'For detailed patterns and recipes, AutoSnippet MCP tools are available:',
-      '- `autosnippet_search({ query })` — search knowledge base (auto mode: BM25 + semantic)',
-      '- `autosnippet_search({ query, mode: "context" })` — context-aware search with history',
-    ];
-    return `${lines.join('\n')}\n`;
-  }
-
-  /**
-   * @private
-   */
-  _renderChannelB(topic, body, description) {
-    const topicLabel = topic.charAt(0).toUpperCase() + topic.slice(1);
-    const lines = [
-      '---',
-      `description: "${description}"`,
-      'alwaysApply: false',
-      '---',
-      '',
-      `# ${topicLabel} Patterns`,
-      '',
-      body,
-      '',
-      `For full code examples: \`autosnippet_search("${topic}")\``,
-    ];
-    return `${lines.join('\n')}\n`;
-  }
-
-  /**
-   * @private
-   */
-  _ensureDir() {
-    if (!fs.existsSync(this.rulesDir)) {
-      fs.mkdirSync(this.rulesDir, { recursive: true });
-    }
-  }
-}
-
-export default RulesGenerator;