autosnippet 2.9.0 → 2.11.0

package/README.md

@@ -86,7 +86,7 @@ asd status         # 自检项目根、AI Provider、索引、Dashboard
 
 ```
 用户：「扫描 NetworkModule 这个 Target，提取最佳实践」
-Cursor → autosnippet_get_targets → autosnippet_get_target_files → 逐文件提取 → autosnippet_submit_candidates
+Cursor → get_targets → get_target_files → 逐文件提取 → submit_knowledge_batch
 → Dashboard Candidates 页面审核 → 保存为 Recipe
 ```
 
@@ -171,20 +171,20 @@ asd install:vscode-copilot      # 配置 MCP 和 Copilot 指令
 
 ## MCP 工具一览
 
-38 个 MCP 工具按功能分组：
+38 个 MCP 工具按功能分组（省略了 **autosnippet_** 前缀）：
 
 | 分类 | 工具 |
 |------|------|
-| **系统** | `autosnippet_health`、`autosnippet_capabilities` |
-| **搜索** | `autosnippet_search`（统合入口）、`autosnippet_context_search`（4 层漏斗）、`autosnippet_keyword_search`、`autosnippet_semantic_search` |
-| **Recipe 浏览** | `autosnippet_list_recipes`、`autosnippet_get_recipe`、`autosnippet_list_rules`、`autosnippet_list_patterns`、`autosnippet_list_facts`、`autosnippet_recipe_insights`、`autosnippet_confirm_usage` |
-| **候选管理** | `autosnippet_validate_candidate`、`autosnippet_check_duplicate`、`autosnippet_submit_candidate`、`autosnippet_submit_candidates`、`autosnippet_submit_draft_recipes`、`autosnippet_enrich_candidates` |
-| **知识图谱** | `autosnippet_graph_query`、`autosnippet_graph_impact`、`autosnippet_graph_path`、`autosnippet_graph_stats` |
-| **项目结构** | `autosnippet_get_targets`、`autosnippet_get_target_files`、`autosnippet_get_target_metadata` |
-| **Guard** | `autosnippet_guard_check`、`autosnippet_guard_audit_files`、`autosnippet_scan_project` |
-| **冷启动** | `autosnippet_bootstrap_knowledge`、`autosnippet_bootstrap_refine` |
-| **Skills** | `autosnippet_list_skills`、`autosnippet_load_skill`、`autosnippet_create_skill`、`autosnippet_delete_skill`、`autosnippet_update_skill`、`autosnippet_suggest_skills` |
-| **治理** | `autosnippet_compliance_report` |
+| **系统** | `health`、`capabilities` |
+| **搜索** | `search`（统合入口）、`context_search`（4 层漏斗）、`keyword_search`、`semantic_search` |
+| **Recipe 浏览** | `list_recipes`、`get_recipe`、`list_rules`、`patterns`、`list_facts`、`recipe_insights`、`confirm_usage` |
+| **候选管理** | `validate_candidate`、`check_duplicate`、`submit_knowledge`、`submit_knowledge_batch`、`submit_knowledge_batch`、`enrich_candidates` |
+| **知识图谱** | `graph_query`、`graph_impact`、`graph_path`、`graph_stats` |
+| **项目结构** | `get_targets`、`get_target_files`、`get_target_metadata` |
+| **Guard** | `guard_check`、`guard_audit_files`、`scan_project` |
+| **冷启动** | `bootstrap_knowledge`、`bootstrap_refine` |
+| **Skills** | `list_skills`、`load_skill`、`create_skill`、`delete_skill`、`update_skill`、`suggest_skills` |
+| **治理** | `compliance_report` |
 
 ## 配置
 

package/bin/cli.js

@@ -5,7 +5,7 @@
  * 
  * Usage:
  *   asd setup           - 初始化项目
- *   asd ais [Target]    - AI 扫描 Target → Candidates
+ *   asd ais [Target]    - AI 扫描 Target → 直接发布 Recipes
  *   asd search <query>  - 搜索知识库
  *   asd guard <file>    - Guard 检查
  *   asd watch           - 文件监控
@@ -78,10 +78,10 @@ program
 // ─────────────────────────────────────────────────────
 program
   .command('ais [target]')
-  .description('AI 扫描 Target 源码 → 提取 Candidates（需配置 AI Provider）')
+  .description('AI 扫描 Target 源码 → 提取并发布 Recipes（需配置 AI Provider）')
   .option('-d, --dir <path>', '项目目录', '.')
   .option('-m, --max-files <n>', '最大扫描文件数', '200')
-  .option('--dry-run', '仅预览，不创建 Candidate')
+  .option('--dry-run', '仅预览，不发布 Recipe')
   .option('--json', '以 JSON 格式输出')
   .action(async (target, opts) => {
     const projectRoot = resolve(opts.dir);
@@ -99,7 +99,7 @@ program
       const scanner = new AiScanService({ container, projectRoot });
 
       const ora = (await import('ora')).default;
-      const spinner = ora('正在扫描源文件并提取候选...').start();
+      const spinner = ora('正在扫描源文件并提取 Recipe...').start();
 
       const report = await scanner.scan(target || null, {
         maxFiles: parseInt(opts.maxFiles, 10),
@@ -114,7 +114,7 @@ program
         console.log(`\n✅ AI 扫描完成`);
         console.log(`   扫描文件: ${report.files}`);
         console.log(`   跳过: ${report.skipped}`);
-        console.log(`   提取候选: ${report.candidates}`);
+        console.log(`   发布 Recipe: ${report.published}`);
         if (report.errors.length > 0) {
           console.log(`\n⚠️  ${report.errors.length} 个错误：`);
           for (const err of report.errors.slice(0, 10)) {
@@ -122,8 +122,8 @@ program
           }
           if (report.errors.length > 10) console.log(`   ... 及其他 ${report.errors.length - 10} 个`);
         }
-        if (!opts.dryRun && report.candidates > 0) {
-          console.log(`\n📋 候选已创建，请运行 asd ui 打开 Dashboard 审核`);
+        if (!opts.dryRun && report.published > 0) {
+          console.log(`\n📋 Recipe 已发布，可通过 asd search 或 Cursor Rules 使用`);
         }
       }
 
@@ -490,6 +490,47 @@ program
     });
   });
 
+// ─────────────────────────────────────────────────────
+// cursor-rules 命令
+// ─────────────────────────────────────────────────────
+program
+  .command('cursor-rules')
+  .description('生成 Cursor 4 通道交付物料（Rules + Skills → .cursor/）')
+  .option('-d, --dir <path>', '项目目录', '.')
+  .option('--verbose', '详细输出')
+  .action(async (opts) => {
+    const projectRoot = resolve(opts.dir);
+
+    console.log(`\n🚀 AutoSnippet — Cursor Delivery Pipeline`);
+    console.log(`   项目: ${basename(projectRoot)}`);
+    console.log(`   路径: ${projectRoot}\n`);
+
+    const { bootstrap, container } = await initContainer({ projectRoot });
+    try {
+      const pipeline = container.get('cursorDeliveryPipeline');
+      const result = await pipeline.deliver();
+
+      console.log(`✅ Cursor 交付物料生成完成\n`);
+      console.log(`   Channel A (Always-On Rules): ${result.channelA.rulesCount} 条规则 (${result.channelA.tokensUsed} tokens)`);
+      console.log(`   Channel B (Smart Rules):     ${result.channelB.topicCount} 个主题, ${result.channelB.patternsCount} 个模式 (${result.channelB.totalTokens} tokens)`);
+      console.log(`   Channel C (Agent Skills):    ${result.channelC.synced} 个 Skills 已同步`);
+      if (result.channelC.errors > 0) {
+        console.log(`   ⚠️  ${result.channelC.errors} 个错误`);
+      }
+      console.log(`\n   总耗时: ${result.stats.duration}ms`);
+
+      if (opts.verbose && result.channelB.topics) {
+        console.log(`\n   Channel B 主题明细:`);
+        for (const [topic, info] of Object.entries(result.channelB.topics)) {
+          console.log(`     - ${topic}: ${info.patternsCount} patterns (${info.tokensUsed} tokens)`);
+        }
+      }
+      console.log('');
+    } finally {
+      await bootstrap.shutdown?.();
+    }
+  });
+
 // ─────────────────────────────────────────────────────
 // sync 命令
 // ─────────────────────────────────────────────────────
@@ -501,12 +542,10 @@ program
   .option('--force', '忽略 hash 强制覆盖')
   .action(async (opts) => {
     const projectRoot = resolve(opts.dir);
-    const { SyncService } = await import('../lib/cli/SyncService.js');
-    const { CandidateSyncService } = await import('../lib/cli/CandidateSyncService.js');
-    const syncService = new SyncService(projectRoot);
-    const candidateSyncService = new CandidateSyncService(projectRoot);
+    const { KnowledgeSyncService } = await import('../lib/cli/KnowledgeSyncService.js');
+    const syncService = new KnowledgeSyncService(projectRoot);
 
-    console.log(`\n🔄 AutoSnippet V2 — 同步 recipes + candidates`);
+    console.log(`\n🔄 AutoSnippet V3 — 同步 knowledge entries`);
     console.log(`   项目: ${basename(projectRoot)}`);
     console.log(`   路径: ${projectRoot}`);
     if (opts.dryRun) console.log('   模式: dry-run（仅报告）');
@@ -533,7 +572,7 @@ program
       });
 
       // 输出报告
-      console.log(`✅ Recipes 同步完成`);
+      console.log(`✅ Knowledge 同步完成`);
       console.log(`   扫描: ${report.synced + report.skipped} 文件`);
       console.log(`   新增: ${report.created}`);
       console.log(`   更新: ${report.updated}`);
@@ -547,38 +586,12 @@ program
       }
 
       if (report.orphaned.length > 0) {
-        console.log(`\n🗑️  ${report.orphaned.length} 个孤儿 Recipe 已标记 deprecated：`);
+        console.log(`\n🗑️  ${report.orphaned.length} 个孤儿条目已标记 deprecated：`);
         for (const id of report.orphaned) {
           console.log(`   - ${id}`);
         }
       }
 
-      // ── Candidates 同步 ──
-      const cReport = candidateSyncService.sync(db, {
-        dryRun: opts.dryRun,
-        force: opts.force,
-      });
-
-      console.log(`\n✅ Candidates 同步完成`);
-      console.log(`   扫描: ${cReport.synced + cReport.skipped} 文件`);
-      console.log(`   新增: ${cReport.created}`);
-      console.log(`   更新: ${cReport.updated}`);
-      console.log(`   跳过: ${cReport.skipped}`);
-
-      if (cReport.violations.length > 0) {
-        console.log(`\n⚠️  检测到 ${cReport.violations.length} 个 Candidate 手动编辑：`);
-        for (const v of cReport.violations) {
-          console.log(`   - ${v}`);
-        }
-      }
-
-      if (cReport.orphaned.length > 0) {
-        console.log(`\n📋 ${cReport.orphaned.length} 个 Candidate 仅存于 DB（无 .md 文件）：`);
-        for (const id of cReport.orphaned) {
-          console.log(`   - ${id}`);
-        }
-      }
-
       console.log('');
     } finally {
       await bootstrap.shutdown?.();

package/config/constitution.yaml

@@ -32,12 +32,19 @@ roles:
       - "read:recipes"
       - "read:guard_rules"
       - "create:candidates"
-      - "submit:candidates"
+      - "candidate:update"
+      - "knowledge:create"
+      - "knowledge:update"
+      - "submit:knowledge"
       - "read:audit_logs:self"
       - "knowledge:bootstrap"
       - "create:skills"
+      - "update:skills"
+      - "delete:skills"
     constraints:
-      - "cannot modify Recipe directly"
+      - "can submit knowledge entries (all go to pending)"
+      - "cannot publish/deprecate knowledge — only developer can do that"
+      - "can reactivate deprecated entries back to pending"
       - "cannot modify Guard rules"
       - "cannot delete any data"
   - id: "chat_agent"