autosnippet 2.8.3 → 2.10.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
 ```
 
@@ -96,7 +96,7 @@ Cursor → autosnippet_get_targets → autosnippet_get_target_files → 逐文
 
 ## Dashboard
 
-`asd ui` 启动后访问 Web 管理后台（默认 http://127.0.0.1:3000）：
+`asd ui` 启动后访问 Web 管理后台：
 
 ![Dashboard](./resources/ASImage02.png)
 
@@ -171,14 +171,14 @@ asd install:vscode-copilot      # 配置 MCP 和 Copilot 指令
 
 ## MCP 工具一览
 
-38 个 MCP 工具按功能分组：
+38 个 MCP 工具按功能分组（省略了 **autosnippet_** 前缀）：
 
 | 分类 | 工具 |
 |------|------|
-| **系统** | `autosnippet_health`、`autosnippet_capabilities` |
+| **系统** | `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_validate_candidate`、`autosnippet_check_duplicate`、`autosnippet_submit_knowledge`、`autosnippet_submit_knowledge_batch`、`autosnippet_submit_knowledge_batch`、`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` |

package/bin/cli.js

@@ -501,12 +501,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 +531,7 @@ program
       });
 
       // 输出报告
-      console.log(`✅ Recipes 同步完成`);
+      console.log(`✅ Knowledge 同步完成`);
       console.log(`   扫描: ${report.synced + report.skipped} 文件`);
       console.log(`   新增: ${report.created}`);
       console.log(`   更新: ${report.updated}`);
@@ -547,38 +545,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"