autosnippet 3.2.13 → 3.2.16

package/config/constitution.yaml

@@ -61,6 +61,25 @@ roles:
     constraints:
       - "candidate must include reasoning"
       - "cannot bypass Guard check"
+  - id: "contributor"
+    name: "Contributor"
+    description: "有子仓库但无 push 权限的团队成员（只读）"
+    permissions:
+      - "read:recipes"
+      - "read:candidates"
+      - "read:guard_rules"
+      - "read:audit_logs:self"
+    constraints:
+      - "不能创建/修改 Recipe（无子仓库写权限）"
+      - "不能修改 Guard 规则"
+  - id: "visitor"
+    name: "Visitor"
+    description: "严格模式下的最小权限访客"
+    permissions:
+      - "read:recipes"
+      - "read:guard_rules"
+    constraints:
+      - "仅可读取，不能执行任何写操作"
   - id: "developer"
     name: "Developer"
     description: "project owner, full access"

package/config/default.json

@@ -64,7 +64,12 @@
       "enabled": true,
       "rrfK": 60,
       "alpha": 0.5
-    }
+    },
+    "contextualEnrich": false,
+    "contextualModel": "claude-sonnet-4-20250514",
+    "autoSyncOnCrud": true,
+    "syncDebounceMs": 2000,
+    "dimensionGuard": true
   },
   "qualityGate": {
     "maxErrors": 0,

package/dist/bin/cli.d.ts

@@ -3,7 +3,8 @@
  * AutoSnippet V2 CLI
  *
  * Usage:
- *   asd setup           - 初始化项目
+ *   asd setup           - 初始化项目（--repo 指定子仓库远程地址）
+ *   asd remote <url>    - 将 recipes 目录转为独立子仓库并关联远程仓库
  *   asd coldstart       - 冷启动知识库（9 维度分析 + AI 填充）
  *   asd ais [Target]    - AI 扫描 Target → 直接发布 Recipes
  *   asd search <query>  - 搜索知识库

package/dist/bin/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/bin/cli.js

@@ -3,7 +3,8 @@
  * AutoSnippet V2 CLI
  *
  * Usage:
- *   asd setup           - 初始化项目
+ *   asd setup           - 初始化项目（--repo 指定子仓库远程地址）
+ *   asd remote <url>    - 将 recipes 目录转为独立子仓库并关联远程仓库
  *   asd coldstart       - 冷启动知识库（9 维度分析 + AI 填充）
  *   asd ais [Target]    - AI 扫描 Target → 直接发布 Recipes
  *   asd search <query>  - 搜索知识库
@@ -16,7 +17,7 @@
  *   asd mirror          - 镜像 .cursor/ → .qoder/ .trae/
  *   asd status          - 环境状态
  */
-import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs';
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { Command } from 'commander';
 import { cli } from '../lib/cli/CliLogger.js';
@@ -50,17 +51,104 @@ program
     .option('-d, --dir <path>', '项目目录', '.')
     .option('--force', '强制覆盖已有配置')
     .option('--seed', '预置示例 Recipe（冷启动推荐）')
+    .option('--repo <url>', 'recipes 子仓库的远程 Git 仓库地址（提供则 clone，不提供则为普通目录）')
     .action(async (opts) => {
     const { SetupService } = await import('../lib/cli/SetupService.js');
     const service = new SetupService({
         projectRoot: resolve(opts.dir),
         force: opts.force,
         seed: opts.seed,
+        subRepoUrl: opts.repo,
     });
     await service.run();
     service.printSummary();
 });
 // ─────────────────────────────────────────────────────
+// remote 命令 — 将 recipes 目录转为独立子仓库并关联远程仓库
+// ─────────────────────────────────────────────────────
+program
+    .command('remote <url>')
+    .description('将 recipes 目录转为独立子仓库并关联远程 Git 仓库')
+    .option('-d, --dir <path>', '项目目录', '.')
+    .action(async (url, opts) => {
+    const projectRoot = resolve(opts.dir);
+    const { execSync: exec } = await import('node:child_process');
+    const { resolveSubRepoPath, isGitRepo } = await import('../lib/shared/ProjectMarkers.js');
+    const subRepoPath = resolveSubRepoPath(projectRoot);
+    // 1. 校验目录存在
+    if (!existsSync(subRepoPath)) {
+        cli.error('recipes/ 目录不存在，请先运行 asd setup');
+        process.exit(1);
+    }
+    // 2. URL 格式验证
+    if (!/^(https?:\/\/.+|git@.+:.+)$/.test(url)) {
+        cli.error('无效的 Git 仓库地址（支持 HTTPS 和 SSH 格式）');
+        process.exit(1);
+    }
+    const gitExec = (args) => {
+        return exec(`git ${args}`, { cwd: subRepoPath, stdio: 'pipe', encoding: 'utf8' }).trim();
+    };
+    // 3. 已经是 git 仓库 → 只更新 remote
+    if (isGitRepo(subRepoPath)) {
+        try {
+            gitExec(`remote get-url origin`);
+            // origin 已存在 → set-url
+            gitExec(`remote set-url origin ${url}`);
+        }
+        catch {
+            // origin 不存在 → add
+            gitExec(`remote add origin ${url}`);
+        }
+        // 更新 config.json
+        _updateConfigUrl(projectRoot, url);
+        cli.log('✓ 已更新 remote origin');
+        cli.log(`  ${url}`);
+        return;
+    }
+    // 4. 普通目录 → 初始化为 git 仓库（保留已有文件）
+    cli.log('正在将 recipes/ 转为独立子仓库...');
+    gitExec('init');
+    gitExec(`remote add origin ${url}`);
+    gitExec('add .');
+    try {
+        gitExec('commit -m "Init AutoSnippet recipes"');
+    }
+    catch {
+        /* 空目录时 commit 可能失败，无影响 */
+    }
+    // 5. 更新 config.json
+    _updateConfigUrl(projectRoot, url);
+    cli.log('✓ recipes/ 已转为独立子仓库');
+    cli.log(`  remote origin → ${url}`);
+    cli.log('');
+    cli.log('后续步骤：');
+    cli.log('  1. git push -u origin main');
+    cli.log('  2. 在主仓库中选择一种方式管理 recipes/:');
+    cli.log(`     • git submodule add ${url} AutoSnippet/recipes`);
+    cli.log('     • 或将 AutoSnippet/recipes/ 加入 .gitignore');
+});
+/**
+ * 更新 .autosnippet/config.json 中的 core.subRepoUrl 字段
+ */
+function _updateConfigUrl(projectRoot, url) {
+    const configPath = join(projectRoot, '.autosnippet', 'config.json');
+    if (!existsSync(configPath)) {
+        return;
+    }
+    try {
+        const raw = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(raw);
+        if (!config.core) {
+            config.core = {};
+        }
+        config.core.subRepoUrl = url;
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+    catch {
+        /* config 解析失败不阻塞主流程 */
+    }
+}
+// ─────────────────────────────────────────────────────
 // coldstart 命令 (Knowledge Bootstrap)
 // ─────────────────────────────────────────────────────
 program
@@ -156,7 +244,7 @@ program
                 try {
                     const taskManager = container.get('bootstrapTaskManager');
                     const sessionStatus = taskManager.getSessionStatus();
-                    if (!sessionStatus || !sessionStatus.tasks) {
+                    if (!sessionStatus || !('tasks' in sessionStatus)) {
                         break;
                     }
                     const total = sessionStatus.tasks.length;
@@ -173,10 +261,10 @@ program
                         waitSpinner.succeed(`AI 填充完成: ${total} 个维度`);
                         // 输出各维度结果
                         if (!opts.json) {
-                            const succeeded = sessionStatus.tasks.filter((t) => t.status === 'done').length;
-                            const failed = sessionStatus.tasks.filter((t) => t.status === 'error').length;
+                            const succeeded = ('tasks' in sessionStatus ? sessionStatus.tasks : []).filter((t) => t.status === 'done').length;
+                            const failed = ('tasks' in sessionStatus ? sessionStatus.tasks : []).filter((t) => t.status === 'error').length;
                             cli.log(`\n  Results: ${succeeded} succeeded, ${failed} failed`);
-                            for (const t of sessionStatus.tasks) {
+                            for (const t of 'tasks' in sessionStatus ? sessionStatus.tasks : []) {
                                 const icon = t.status === 'done' ? '✅' : '❌';
                                 cli.log(`    ${icon} ${t.meta?.label || t.id}`);
                             }
@@ -492,7 +580,7 @@ program
             cli.log(`\n🔍 Guard (staged): ${summary.totalViolations} violation(s) in ${sourceFiles.length} file(s)\n`);
             const filesWithIssues = result.files.filter((f) => f.summary.total > 0);
             for (const file of filesWithIssues.slice(0, 10)) {
-                cli.log(`  📄 ${file.filePath || file.path}`);
+                cli.log(`  📄 ${file.filePath}`);
                 for (const v of file.violations.slice(0, 5)) {
                     const icon = v.severity === 'error' ? '❌' : '⚠️';
                     cli.log(`    ${icon} [${v.ruleId}] ${v.message}`);
@@ -633,6 +721,16 @@ program
             });
             signalCollector.start();
             globalThis._signalCollector = signalCollector;
+            // 将 SignalCollector 绑定到 AIRecallStrategy (延迟注入)
+            try {
+                const aiStrategy = container.singletons._aiRecallStrategy;
+                if (aiStrategy && typeof aiStrategy.setSignalCollector === 'function') {
+                    aiStrategy.setSignalCollector(signalCollector);
+                }
+            }
+            catch {
+                /* recommendation pipeline not yet initialized */
+            }
         }
         catch (scErr) {
             cli.warn(`⚠️  SignalCollector failed to start: ${scErr.message}`);
@@ -811,6 +909,112 @@ program
     cli.blank();
 });
 // ─────────────────────────────────────────────────────
+// embed 命令 — 构建/重建语义向量索引
+// ─────────────────────────────────────────────────────
+program
+    .command('embed')
+    .description('构建/重建语义向量索引')
+    .option('-d, --dir <path>', '项目目录', '.')
+    .option('--force', '忽略增量检测，全量重建')
+    .option('--clear', '清空现有索引后重建')
+    .option('--dry-run', '只报告不执行')
+    .option('--json', 'JSON 输出')
+    .option('--validate', '只验证索引健康状态')
+    .action(async (opts) => {
+    const projectRoot = resolve(opts.dir);
+    const { bootstrap, container } = await initContainer({ projectRoot });
+    try {
+        // 优先使用 VectorService，降级到 IndexingPipeline
+        const hasVectorService = !!container.services.vectorService;
+        if (opts.validate) {
+            if (hasVectorService) {
+                const vs = container.get('vectorService');
+                const validation = await vs.validate();
+                const stats = await vs.getStats();
+                if (opts.json) {
+                    cli.json({ validation, stats });
+                }
+                else {
+                    cli.log('\n  Vector Index Health Check');
+                    cli.log(`  ${'─'.repeat(40)}`);
+                    cli.log(`  Status:    ${validation.healthy ? '✅ Healthy' : '⚠️  Issues found'}`);
+                    cli.log(`  Entries:   ${stats.count ?? 0}`);
+                    cli.log(`  Dimension: ${stats.dimension ?? 0}`);
+                    cli.log(`  Quantized: ${stats.quantized ?? false}`);
+                    cli.log(`  Embed:     ${stats.embedProviderAvailable ? 'Available' : 'Not configured'}`);
+                    if (validation.issues.length > 0) {
+                        cli.log(`\n  Issues:`);
+                        for (const issue of validation.issues) {
+                            cli.log(`    • ${issue}`);
+                        }
+                    }
+                    cli.blank();
+                }
+            }
+            else {
+                cli.log('VectorService not available. Configure an AI API key first.');
+            }
+            return;
+        }
+        if (hasVectorService) {
+            const vs = container.get('vectorService');
+            if (opts.clear) {
+                await vs.clear();
+                cli.log('  🗑️  Existing vector index cleared.');
+            }
+            const start = Date.now();
+            cli.log('  Building semantic index...');
+            const result = await vs.fullBuild({
+                force: opts.force ?? false,
+                dryRun: opts.dryRun ?? false,
+            });
+            const duration = ((Date.now() - start) / 1000).toFixed(1);
+            if (opts.json) {
+                cli.json(result);
+            }
+            else {
+                cli.log('\n  Embedding Report');
+                cli.log(`  ${'─'.repeat(40)}`);
+                cli.log(`  Scanned:   ${result.scanned ?? 0} files`);
+                cli.log(`  Chunked:   ${result.chunked ?? 0} chunks`);
+                cli.log(`  Enriched:  ${result.enriched ?? 0} (contextual)`);
+                cli.log(`  Embedded:  ${result.embedded ?? 0}`);
+                cli.log(`  Upserted:  ${result.upserted ?? 0}`);
+                cli.log(`  Skipped:   ${result.skipped ?? 0} (unchanged)`);
+                cli.log(`  Errors:    ${result.errors ?? 0}`);
+                cli.log(`  Duration:  ${duration}s`);
+                cli.blank();
+            }
+        }
+        else {
+            // 降级: 直接使用 IndexingPipeline
+            const pipeline = container.get('indexingPipeline');
+            const result = await pipeline.run({
+                force: opts.force ?? false,
+                dryRun: opts.dryRun ?? false,
+                clear: opts.clear ?? false,
+            });
+            if (opts.json) {
+                cli.json(result);
+            }
+            else {
+                cli.log('\n  Embedding Report (pipeline mode)');
+                cli.log(`  ${'─'.repeat(40)}`);
+                cli.log(`  Scanned:  ${result.scanned} files`);
+                cli.log(`  Chunked:  ${result.chunked} chunks`);
+                cli.log(`  Embedded: ${result.embedded}`);
+                cli.log(`  Upserted: ${result.upserted}`);
+                cli.log(`  Skipped:  ${result.skipped} (unchanged)`);
+                cli.log(`  Errors:   ${result.errors}`);
+                cli.blank();
+            }
+        }
+    }
+    finally {
+        await bootstrap.shutdown?.();
+    }
+});
+// ─────────────────────────────────────────────────────
 // upgrade 命令
 // ─────────────────────────────────────────────────────
 program
@@ -843,9 +1047,9 @@ program
         const result = await pipeline.deliver();
         cli.log('\n  Cursor Rules Delivery');
         cli.log(`  ${'─'.repeat(40)}`);
-        cli.log(`  Channel A: ${result.channelA?.count ?? '?'} always-on rules`);
-        cli.log(`  Channel B: ${result.channelB?.count ?? Object.keys(result.channelB?.topics || {}).length} topic rules`);
-        cli.log(`  Channel C: ${result.channelC?.count ?? '?'} skills (${result.channelC?.errors ?? 0} errors)`);
+        cli.log(`  Channel A: ${result.channelA?.rulesCount ?? '?'} always-on rules`);
+        cli.log(`  Channel B: ${result.channelB?.topicCount ?? Object.keys(result.channelB?.topics || {}).length} topic rules`);
+        cli.log(`  Channel C: ${result.channelC?.synced ?? '?'} skills (${result.channelC?.errors ?? 0} errors)`);
         if (result.channelC.errors > 0) {
             cli.log(`  ⚠️  ${result.channelC.errors} skill(s) failed to deliver`);
         }
@@ -890,9 +1094,15 @@ taskCmd
             cli.log(`\n  ID               Status        Priority  Title`);
             cli.log(`  ${'─'.repeat(70)}`);
             for (const t of tasks) {
+                if (!t) {
+                    continue;
+                }
                 const j = t.toJSON ? t.toJSON() : t;
-                const id = (j.id || '').padEnd(16);
-                const status = (j.status || '').padEnd(13);
+                if (!j) {
+                    continue;
+                }
+                const id = String(j.id || '').padEnd(16);
+                const status = String(j.status || '').padEnd(13);
                 const pri = String(j.priority ?? '-').padEnd(9);
                 cli.log(`  ${id} ${status} ${pri} ${j.title}`);
             }
@@ -922,13 +1132,20 @@ taskCmd
         }
         else {
             for (const t of tasks) {
+                if (!t) {
+                    continue;
+                }
                 const j = t.toJSON ? t.toJSON() : t;
+                if (!j) {
+                    continue;
+                }
                 cli.log(`\n  ▸ ${j.id} — ${j.title} (P${j.priority ?? '?'})`);
-                if (t.knowledgeContext?.relatedKnowledge?.length) {
-                    cli.log(`    Knowledge: ${t.knowledgeContext.relatedKnowledge.map((k) => k.title).join(', ')}`);
+                const kCtx = t.knowledgeContext;
+                if (kCtx?.relatedKnowledge?.length) {
+                    cli.log(`    Knowledge: ${kCtx.relatedKnowledge.map((k) => k.title).join(', ')}`);
                 }
-                if (t.knowledgeContext?.guardRules?.length) {
-                    cli.log(`    Guard: ${t.knowledgeContext.guardRules.map((r) => r.title).join(', ')}`);
+                if (kCtx?.guardRules?.length) {
+                    cli.log(`    Guard: ${kCtx.guardRules.map((r) => r.title).join(', ')}`);
                 }
             }
             cli.blank();
@@ -948,20 +1165,22 @@ taskCmd
     try {
         const svc = container.get('taskGraphService');
         const result = await svc.prime({ withKnowledge: true });
+        const inProgress = result.inProgress;
+        const ready = result.ready;
         cli.log(`\n  TaskGraph Prime`);
         cli.log(`  ${'─'.repeat(40)}`);
-        cli.log(`  In Progress: ${result.inProgress.length}`);
-        cli.log(`  Ready:       ${result.ready.length}`);
+        cli.log(`  In Progress: ${inProgress.length}`);
+        cli.log(`  Ready:       ${ready.length}`);
         cli.log(`  Stats:       ${JSON.stringify(result.stats)}`);
-        if (result.inProgress.length > 0) {
+        if (inProgress.length > 0) {
             cli.log(`\n  ▸ In Progress:`);
-            for (const t of result.inProgress) {
+            for (const t of inProgress) {
                 cli.log(`    ${t.id} — ${t.title}`);
             }
         }
-        if (result.ready.length > 0) {
+        if (ready.length > 0) {
             cli.log(`\n  ▸ Ready:`);
-            for (const t of result.ready) {
+            for (const t of ready) {
                 cli.log(`    ${t.id} — ${t.title}`);
             }
         }