autosnippet 2.12.0 → 2.14.0

package/lib/external/mcp/handlers/knowledge.js

@@ -237,6 +237,80 @@ export async function knowledgeLifecycle(ctx, args) {
 
 // ─── 内部辅助 ──────────────────────────────────────────────
 
+/**
+ * 保存开发文档 (autosnippet_save_document)
+ *
+ * 精简入口：仅需 title + markdown。
+ * 自动设置 knowledgeType='dev-document', kind='fact', source='agent'。
+ * 不走 RecipeReadiness 检查（文档无需 doClause/trigger）。
+ * 支持 autoApprove — 文档直接进入 active 状态。
+ */
+export async function saveDocument(ctx, args) {
+  if (!args.title || !args.title.trim()) {
+    throw new Error('title 必填');
+  }
+  if (!args.markdown || !args.markdown.trim()) {
+    throw new Error('markdown 必填');
+  }
+
+  // 限流
+  const blocked = await _checkRateLimit('autosnippet_save_document', args.client_id);
+  if (blocked) return blocked;
+
+  const service = ctx.container.get('knowledgeService');
+
+  const data = {
+    title:         args.title.trim(),
+    description:   args.description || '',
+    knowledgeType: 'dev-document',
+    kind:          'fact',
+    source:        args.source || 'agent',
+    scope:         args.scope || 'project-specific',
+    tags:          args.tags || [],
+    content: {
+      markdown: args.markdown,
+      pattern:  '',
+    },
+    // 文档不需要 Cursor Delivery 字段
+    trigger:    '',
+    doClause:   '',
+    dontClause: '',
+    whenClause: '',
+    topicHint:  '',
+    coreCode:   '',
+    // 基础推理
+    reasoning: {
+      whyStandard: 'Agent development document — preserved for team knowledge',
+      sources:     ['agent'],
+      confidence:  0.8,
+    },
+  };
+
+  const entry = await service.create(data, { userId: 'mcp' });
+
+  // 自动发布（dev-document 不需要人工审核）
+  try {
+    await service.publish(entry.id, { userId: 'mcp' });
+  } catch {
+    // 发布失败保持 pending — 非阻塞
+  }
+
+  return envelope({
+    success: true,
+    data: {
+      id:        entry.id,
+      lifecycle: 'active',
+      title:     entry.title,
+      kind:      'fact',
+      knowledgeType: 'dev-document',
+    },
+    message: `文档「${entry.title}」已保存到知识库。`,
+    meta: { tool: 'autosnippet_save_document' },
+  });
+}
+
+// ─── 内部辅助 ──────────────────────────────────────────────
+
 /**
  * V3 wire format → RecipeReadinessChecker 兼容格式
  */

package/lib/external/mcp/tools.js

@@ -23,6 +23,7 @@ export const TOOL_GATEWAY_MAP = {
   autosnippet_submit_knowledge: { action: 'knowledge:create', resource: 'knowledge' },
   autosnippet_submit_knowledge_batch: { action: 'knowledge:create', resource: 'knowledge' },
   autosnippet_knowledge_lifecycle: { action: 'knowledge:update', resource: 'knowledge' },
+  autosnippet_save_document: { action: 'knowledge:create', resource: 'knowledge' },
 };
 
 export const TOOLS = [
@@ -751,4 +752,26 @@ export const TOOLS = [
       required: ['id', 'action'],
     },
   },
+  // 39. 保存开发文档
+  {
+    name: 'autosnippet_save_document',
+    description:
+      '保存开发文档到知识库（架构设计、排查报告、决策记录、调研笔记等）。\n' +
+      '仅需 title + markdown，无需填写 kind/doClause/trigger 等 Cursor Delivery 字段。\n' +
+      '文档自动以 dev-document 类型存储，不参与 Cursor Rules 压缩，保持原文完整性。\n' +
+      '交付路径: Channel D → .cursor/skills/autosnippet-devdocs/references/*.md。\n' +
+      'Agent 可通过 autosnippet_search 全文检索已保存的文档。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title:       { type: 'string', description: '文档标题（中英文皆可）' },
+        markdown:    { type: 'string', description: '文档 Markdown 全文' },
+        description: { type: 'string', description: '一句话摘要（可选）' },
+        tags:        { type: 'array', items: { type: 'string' }, description: '标签列表，如 ["adr", "debug-report", "design-doc", "research"]' },
+        scope:       { type: 'string', enum: ['universal', 'project-specific'], default: 'project-specific', description: '适用范围' },
+        source:      { type: 'string', description: '来源标识（默认 agent）' },
+      },
+      required: ['title', 'markdown'],
+    },
+  },
 ];

package/lib/http/routes/guardRules.js

@@ -291,4 +291,31 @@ router.post('/import-from-recipe', asyncHandler(async (req, res) => {
   });
 }));
 
+/**
+ * GET /api/v1/rules/compliance
+ * 生成全项目合规报告
+ * Query params:
+ *   - path: 扫描根目录（默认 projectRoot）
+ *   - maxErrors: Quality Gate 最大 error 数（默认 0）
+ *   - maxWarnings: Quality Gate 最大 warning 数（默认 20）
+ *   - minScore: Quality Gate 最低分（默认 70）
+ *   - maxFiles: 最大扫描文件数（默认 500）
+ */
+router.get('/compliance', asyncHandler(async (req, res) => {
+  const container = getServiceContainer();
+  const reporter = container.get('complianceReporter');
+  const projectRoot = req.query.path || process.env.ASD_PROJECT_DIR || process.cwd();
+
+  const report = await reporter.generate(projectRoot, {
+    qualityGate: {
+      maxErrors: parseInt(req.query.maxErrors) || 0,
+      maxWarnings: parseInt(req.query.maxWarnings) || 20,
+      minScore: parseInt(req.query.minScore) || 70,
+    },
+    maxFiles: parseInt(req.query.maxFiles) || 500,
+  });
+
+  res.json({ success: true, data: report });
+}));
+
 export default router;

package/lib/injection/ServiceContainer.js

@@ -34,6 +34,8 @@ import { SnippetInstaller } from '../service/snippet/SnippetInstaller.js';
 import { ExclusionManager } from '../service/guard/ExclusionManager.js';
 import { RuleLearner } from '../service/guard/RuleLearner.js';
 import { ViolationsStore } from '../service/guard/ViolationsStore.js';
+import { ComplianceReporter } from '../service/guard/ComplianceReporter.js';
+import { GuardFeedbackLoop } from '../service/guard/GuardFeedbackLoop.js';
 
 // ─── P1: Token Usage Tracking ─────────────────────────
 import { TokenUsageStore } from '../repository/token/TokenUsageStore.js';
@@ -459,6 +461,33 @@ export class ServiceContainer {
       return this.singletons.violationsStore;
     });
 
+    // Guard: ComplianceReporter
+    this.register('complianceReporter', () => {
+      if (!this.singletons.complianceReporter) {
+        const config = this.singletons._config || {};
+        this.singletons.complianceReporter = new ComplianceReporter(
+          this.get('guardCheckEngine'),
+          this.get('violationsStore'),
+          this.get('ruleLearner'),
+          this.get('exclusionManager'),
+          config.qualityGate || {},
+        );
+      }
+      return this.singletons.complianceReporter;
+    });
+
+    // Guard: GuardFeedbackLoop
+    this.register('guardFeedbackLoop', () => {
+      if (!this.singletons.guardFeedbackLoop) {
+        this.singletons.guardFeedbackLoop = new GuardFeedbackLoop(
+          this.get('violationsStore'),
+          this.get('feedbackCollector'),
+          { guardCheckEngine: this.get('guardCheckEngine') },
+        );
+      }
+      return this.singletons.guardFeedbackLoop;
+    });
+
     // Token Usage: 持久化 AI token 消耗
     this.register('tokenUsageStore', () => {
       if (!this.singletons.tokenUsageStore) {

package/lib/service/automation/handlers/GuardHandler.js

@@ -211,9 +211,20 @@ function _auditSingleFile(engine, fullPath, code, detectLanguage, scope = 'file'
     console.log(`  🛡️ ${errors.length} errors, ${warnings.length} warnings`);
     for (const v of errors) {
       console.log(`  ❌ L${v.line} [${v.ruleId}] ${v.message}`);
+      if (v.fixSuggestion) console.log(`     🔧 修复建议: ${v.fixSuggestion}`);
     }
     for (const v of warnings.slice(0, 5)) {
       console.log(`  ⚠️  L${v.line} [${v.ruleId}] ${v.message}`);
+      if (v.fixSuggestion) console.log(`     🔧 修复建议: ${v.fixSuggestion}`);
     }
   }
+
+  // Guard ↔ Recipe 闭环：检测修复并自动确认使用（fire-and-forget）
+  import('../../../injection/ServiceContainer.js').then(({ ServiceContainer }) => {
+    try {
+      const container = ServiceContainer.getInstance();
+      const feedbackLoop = container.get('guardFeedbackLoop');
+      feedbackLoop.processFixDetection({ violations }, fullPath);
+    } catch { /* guardFeedbackLoop not available */ }
+  }).catch(() => { /* ignored */ });
 }

package/lib/service/chat/tools.js

@@ -1844,6 +1844,68 @@ const submitCandidate = {
   },
 };
 
+// ────────────────────────────────────────────────────────────
+// 16b. save_document — 保存开发文档到知识库
+// ────────────────────────────────────────────────────────────
+const saveDocument = {
+  name: 'save_document',
+  description: '保存开发文档到知识库（架构设计、排查报告、决策记录、调研笔记等）。仅需 title + markdown，无需 Cursor Delivery 字段。文档自动发布，可通过 autosnippet_search 检索。',
+  parameters: {
+    type: 'object',
+    properties: {
+      title:       { type: 'string', description: '文档标题' },
+      markdown:    { type: 'string', description: '文档 Markdown 全文' },
+      description: { type: 'string', description: '一句话摘要（可选）' },
+      tags:        { type: 'array', items: { type: 'string' }, description: '标签: adr, debug-report, design-doc, research, performance 等' },
+      scope:       { type: 'string', enum: ['universal', 'project-specific'], description: '适用范围（默认 project-specific）' },
+    },
+    required: ['title', 'markdown'],
+  },
+  handler: async (params, ctx) => {
+    const knowledgeService = ctx.container.get('knowledgeService');
+
+    const data = {
+      title:         params.title.trim(),
+      description:   params.description || '',
+      knowledgeType: 'dev-document',
+      kind:          'fact',
+      source:        'agent',
+      scope:         params.scope || 'project-specific',
+      tags:          params.tags || [],
+      content: {
+        markdown: params.markdown,
+        pattern:  '',
+      },
+      trigger:    '',
+      doClause:   '',
+      dontClause: '',
+      whenClause: '',
+      topicHint:  '',
+      coreCode:   '',
+      reasoning: {
+        whyStandard: 'Agent development document',
+        sources:     ['agent'],
+        confidence:  0.8,
+      },
+    };
+
+    const saved = await knowledgeService.create(data, { userId: 'agent' });
+
+    // 自动发布（文档不需要人工审核）
+    try {
+      await knowledgeService.publish(saved.id, { userId: 'agent' });
+    } catch { /* best effort */ }
+
+    return {
+      id:            saved.id,
+      title:         saved.title,
+      lifecycle:     'active',
+      knowledgeType: 'dev-document',
+      message:       `文档「${saved.title}」已保存到知识库`,
+    };
+  },
+};
+
 // ────────────────────────────────────────────────────────────
 // 17. approve_candidate
 // ────────────────────────────────────────────────────────────
@@ -3273,6 +3335,7 @@ export const ALL_TOOLS = [
   generateGuardRule,
   // 生命周期操作类 (7)
   submitCandidate,
+  saveDocument,
   approveCandidate,
   rejectCandidate,
   publishRecipe,

package/lib/service/cursor/CursorDeliveryPipeline.js

@@ -16,6 +16,7 @@ import { RulesGenerator } from './RulesGenerator.js';
 import { SkillsSyncer } from './SkillsSyncer.js';
 import { estimateTokens, BUDGET } from './TokenBudget.js';
 import path from 'node:path';
+import fs from 'node:fs';
 
 export class CursorDeliveryPipeline {
   /**
@@ -48,6 +49,7 @@ export class CursorDeliveryPipeline {
       channelA: { rulesCount: 0, tokensUsed: 0 },
       channelB: { topicCount: 0, patternsCount: 0, totalTokens: 0 },
       channelC: { synced: 0, skipped: 0, errors: 0 },
+      channelD: { documentsCount: 0, filesWritten: 0 },
       totalTokensUsed: 0,
       duration: 0,
     };
@@ -57,9 +59,9 @@ export class CursorDeliveryPipeline {
       const entries = await this._loadEntries();
       this.logger.info?.(`[CursorDelivery] Loaded ${entries.length} knowledge entries`);
 
-      // 2. 分类：rules vs patterns vs facts
-      const { rules, patterns } = this._classify(entries);
-      this.logger.info?.(`[CursorDelivery] Classified: ${rules.length} rules, ${patterns.length} patterns`);
+      // 2. 分类：rules vs patterns vs facts vs documents
+      const { rules, patterns, documents } = this._classify(entries);
+      this.logger.info?.(`[CursorDelivery] Classified: ${rules.length} rules, ${patterns.length} patterns, ${documents.length} documents`);
 
       // 3. 清理旧的动态生成文件
       this.rulesGenerator.cleanDynamicFiles();
@@ -76,6 +78,10 @@ export class CursorDeliveryPipeline {
       const channelC = await this._generateChannelC();
       stats.channelC = channelC;
 
+      // ── Channel D: Dev Documents → references ──
+      const channelD = this._generateChannelD(documents);
+      stats.channelD = channelD;
+
       // 统计
       stats.totalTokensUsed = channelA.tokensUsed + channelB.totalTokens;
       stats.duration = Date.now() - startTime;
@@ -83,9 +89,10 @@ export class CursorDeliveryPipeline {
       this.logger.info?.(`[CursorDelivery] Done in ${stats.duration}ms — ` +
         `A: ${channelA.rulesCount} rules (${channelA.tokensUsed} tokens), ` +
         `B: ${channelB.topicCount} topics (${channelB.totalTokens} tokens), ` +
-        `C: ${channelC.synced} skills synced`);
+        `C: ${channelC.synced} skills synced, ` +
+        `D: ${channelD.documentsCount} documents`);
 
-      return { channelA, channelB, channelC, stats };
+      return { channelA, channelB, channelC, channelD, stats };
     } catch (error) {
       this.logger.error?.(`[CursorDelivery] Error: ${error.message}`);
       throw error;
@@ -146,16 +153,23 @@ export class CursorDeliveryPipeline {
 
   /**
    * 按 kind 分类知识条目
+   * dev-document 类型单独分流，不进入 Channel A/B 压缩
    * @private
    */
   _classify(entries) {
-    const rules = [], patterns = [], facts = [];
+    const rules = [], patterns = [], facts = [], documents = [];
     for (const entry of entries) {
-      if (entry.kind === 'rule') rules.push(entry);
-      else if (entry.kind === 'fact') facts.push(entry);
-      else patterns.push(entry);  // 无 kind 或 kind='pattern' → pattern
+      if (entry.knowledgeType === 'dev-document') {
+        documents.push(entry);
+      } else if (entry.kind === 'rule') {
+        rules.push(entry);
+      } else if (entry.kind === 'fact') {
+        facts.push(entry);
+      } else {
+        patterns.push(entry);  // 无 kind 或 kind='pattern' → pattern
+      }
     }
-    return { rules, patterns, facts };
+    return { rules, patterns, facts, documents };
   }
 
   /**
@@ -267,6 +281,98 @@ export class CursorDeliveryPipeline {
     }
   }
 
+  /**
+   * Channel D — Dev Documents 生成
+   * 将 knowledgeType='dev-document' 的条目以原始 MD 写入
+   * .cursor/skills/autosnippet-devdocs/references/ 目录
+   * @private
+   */
+  _generateChannelD(documents) {
+    const result = { documentsCount: 0, filesWritten: 0, filePaths: [] };
+    if (!documents || documents.length === 0) {
+      return result;
+    }
+
+    const devdocsDir = path.join(this.projectRoot, '.cursor', 'skills', 'autosnippet-devdocs');
+    const refsDir = path.join(devdocsDir, 'references');
+    fs.mkdirSync(refsDir, { recursive: true });
+
+    // 生成 SKILL.md（索引页）
+    const skillLines = [
+      '---',
+      'name: autosnippet-devdocs',
+      `description: "Development documents and knowledge artifacts for ${this.projectName}. Use when looking up architecture decisions, debug reports, design docs, or analysis notes."`,
+      '---',
+      '',
+      `# Dev Documents — ${this.projectName}`,
+      '',
+      'Use this skill when:',
+      '- Looking up architecture decisions or design rationale',
+      '- Reviewing debug reports or performance analysis',
+      '- Finding previous research or investigation notes',
+      '- Understanding project-specific decisions and trade-offs',
+      '',
+      '## Document Index',
+      '',
+      '| Title | Tags | Updated |',
+      '|-------|------|---------|',
+    ];
+
+    for (const doc of documents) {
+      const tags = (doc.tags || []).join(', ') || '-';
+      const updated = doc.updatedAt
+        ? new Date(doc.updatedAt * 1000).toISOString().split('T')[0]
+        : '-';
+      const slug = this._slugify(doc.title || doc.id);
+      skillLines.push(`| [${doc.title}](references/${slug}.md) | ${tags} | ${updated} |`);
+
+      // 写入单个文档 MD
+      const markdown = doc.content?.markdown || doc.description || '';
+      const docContent = [
+        `# ${doc.title || 'Untitled'}`,
+        '',
+        doc.description ? `> ${doc.description}` : '',
+        '',
+        `**Tags:** ${tags}  `,
+        `**Scope:** ${doc.scope || 'universal'}  `,
+        `**Created:** ${doc.createdAt ? new Date(doc.createdAt * 1000).toISOString().split('T')[0] : '-'}`,
+        '',
+        '---',
+        '',
+        markdown,
+      ].filter(Boolean).join('\n');
+
+      const docPath = path.join(refsDir, `${slug}.md`);
+      fs.writeFileSync(docPath, docContent, 'utf8');
+      result.filePaths.push(docPath);
+      result.filesWritten++;
+    }
+
+    skillLines.push('');
+    skillLines.push('## Deeper Knowledge');
+    skillLines.push('');
+    skillLines.push('For full-text search across all documents:');
+    skillLines.push('- `autosnippet_search("your query")`');
+
+    fs.writeFileSync(path.join(devdocsDir, 'SKILL.md'), skillLines.join('\n') + '\n', 'utf8');
+    result.documentsCount = documents.length;
+
+    this.logger.info?.(`[CursorDelivery] Channel D: ${result.documentsCount} documents → ${refsDir}`);
+    return result;
+  }
+
+  /**
+   * 文件名安全 slug 化
+   * @private
+   */
+  _slugify(text) {
+    return text
+      .toLowerCase()
+      .replace(/[^a-z0-9\u4e00-\u9fff]+/g, '-')
+      .replace(/^-+|-+$/g, '')
+      .substring(0, 80) || 'untitled';
+  }
+
   /**
    * 从项目路径推断项目名称
    * @private