autosnippet 3.2.12 → 3.2.15

package/dist/lib/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../lib/bootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,qCAAqC,CAAC;AAC/D,OAAO,qBAAqB,MAAM,8CAA8C,CAAC;AACjF,OAAO,OAA+B,MAAM,2BAA2B,CAAC;AACxE,OAAO,iBAAiB,MAAM,wCAAwC,CAAC;AACvE,OAAO,WAAW,MAAM,uCAAuC,CAAC;AAChE,OAAO,UAAU,MAAM,sCAAsC,CAAC;AAC9D,OAAO,YAAY,MAAM,yCAAyC,CAAC;AACnE,OAAO,kBAAkB,MAAM,iDAAiD,CAAC;AACjF,OAAO,MAAM,MAAM,oCAAoC,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAI5D;;GAEG;AACH,sBAAsB;AACtB,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAwB;AACxB,UAAU,mBAAmB;IAC3B,MAAM,CAAC,EAAE,OAAO,YAAY,CAAC;IAC7B,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/C,EAAE,CAAC,EAAE,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;IACjD,qBAAqB,CAAC,EAAE,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACnE,iBAAiB,CAAC,EAAE,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC3D,UAAU,CAAC,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,YAAY,CAAC,OAAO,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,SAAS;IACpB,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,gBAAgB,CAAC;gBACd,OAAO,GAAE,gBAAqB;IAK1C;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IASxE;;OAEG;IACG,UAAU;IA+ChB;;OAEG;IACG,UAAU;IAgBhB;;OAEG;IACG,UAAU;IAMhB;;OAEG;IACG,gBAAgB;IAQtB;;OAEG;IACG,kBAAkB;IAWxB;;OAEG;IACG,gBAAgB;IAOtB;;OAEG;IACG,wBAAwB;IA2B9B;;OAEG;IACG,iBAAiB;IAkBvB;;OAEG;IACG,QAAQ;IAkBd;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB;;OAEG;IACH,gBAAgB;CAGjB;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../lib/bootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,qCAAqC,CAAC;AAC/D,OAAO,qBAAqB,MAAM,8CAA8C,CAAC;AACjF,OAAO,OAA+B,MAAM,2BAA2B,CAAC;AACxE,OAAO,iBAAiB,MAAM,wCAAwC,CAAC;AACvE,OAAO,WAAW,MAAM,uCAAuC,CAAC;AAChE,OAAO,UAAU,MAAM,sCAAsC,CAAC;AAC9D,OAAO,YAAY,MAAM,yCAAyC,CAAC;AACnE,OAAO,kBAAkB,MAAM,iDAAiD,CAAC;AACjF,OAAO,MAAM,MAAM,oCAAoC,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAI5D;;GAEG;AACH,sBAAsB;AACtB,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAwB;AACxB,UAAU,mBAAmB;IAC3B,MAAM,CAAC,EAAE,OAAO,YAAY,CAAC;IAC7B,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/C,EAAE,CAAC,EAAE,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;IACjD,qBAAqB,CAAC,EAAE,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACnE,iBAAiB,CAAC,EAAE,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC3D,UAAU,CAAC,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,YAAY,CAAC,OAAO,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,SAAS;IACpB,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,gBAAgB,CAAC;gBACd,OAAO,GAAE,gBAAqB;IAK1C;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IASxE;;OAEG;IACG,UAAU;IA+ChB;;OAEG;IACG,UAAU;IAiBhB;;OAEG;IACG,UAAU;IAMhB;;OAEG;IACG,gBAAgB;IAQtB;;OAEG;IACG,kBAAkB;IAWxB;;OAEG;IACG,gBAAgB;IAOtB;;OAEG;IACG,wBAAwB;IA2B9B;;OAEG;IACG,iBAAiB;IAkBvB;;OAEG;IACG,QAAQ;IAkBd;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB;;OAEG;IACH,gBAAgB;CAGjB;AAED,eAAe,SAAS,CAAC"}

package/dist/lib/bootstrap.js

@@ -82,7 +82,8 @@ export class Bootstrap {
             for (const envPath of candidates) {
                 if (existsSync(envPath)) {
                     const dotenv = await import('dotenv');
-                    dotenv.config({ path: envPath, override: false });
+                    // quiet: true — 禁止 dotenv v17 的 stdout banner，避免污染 MCP stdio 传输
+                    dotenv.config({ path: envPath, override: false, quiet: true });
                     break;
                 }
             }

package/dist/lib/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../lib/bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../lib/bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/lib/cli/SetupService.d.ts

@@ -4,7 +4,7 @@
  * 一键初始化 AutoSnippet V2 工作空间，5 步完成：
  *
  *   Step 1  .autosnippet/ 运行时目录 + config.json + .gitignore
- *   Step 2  AutoSnippet/ 子仓库（核心数据 + 权限能力 + skills/）
+ *   Step 2  AutoSnippet/ 知识库目录结构 + AutoSnippet/recipes/（有 --repo 则 clone，无则为普通目录）
  *   Step 3  IDE 集成（VSCode MCP + Cursor MCP + copilot-instructions + cursor-rules
  *           + skills-template + cursor-workflow + claude-hooks + guard-ci + pre-commit-hook）
  *   Step 4  SQLite 数据库 + V1 数据迁移
@@ -14,15 +14,17 @@
  *
  * 数据架构（核心数据在子仓库，受 git 权限保护）
  * ─────────────────────────────────────────────
- *   AutoSnippet/  (Git 子仓库 = 唯一真实来源 Source of Truth)
+ *   AutoSnippet/  (知识库根目录)
  *     ├─ constitution.yaml    权限宪法：角色 + 权限矩阵 + 治理规则 + 能力探测
  *     ├─ boxspec.json         项目规格定义
- *     ├─ recipes/*.md         统一知识实体（代码规范/模式/架构/调用链/数据流/...）
- *     ├─ skills/             Project Skills（冷启动自动生成 + 手动创建）
+ *     ├─ recipes/             Git 子仓库 = 唯一真实来源 Source of Truth
+ *     │   └─ *.md             统一知识实体（代码规范/模式/架构/调用链/数据流/...）
+ *     ├─ candidates/          候选知识（待审批）
+ *     ├─ skills/              Project Skills（冷启动自动生成 + 手动创建）
  *     └─ README.md
  *
  *   .autosnippet/  (运行时缓存，gitignored)
- *     ├─ config.json          项目配置
+ *     ├─ config.json          项目配置（含 core.subRepoDir 子仓库路径）
  *     ├─ autosnippet.db       SQLite 运行时缓存（从子仓库同步 + candidates/snippets/audit）
  *     ├─ context/             向量索引缓存
  *     └─ logs/                运行日志
@@ -58,13 +60,23 @@ export declare class SetupService {
     runtimeDir: string;
     seed: boolean;
     skillsDir: string;
+    /** 子仓库相对路径（相对于 projectRoot），如 'AutoSnippet/recipes' */
+    subRepoDir: string;
+    /** 子仓库绝对路径 */
+    subRepoPath: string;
+    /** 子仓库远程仓库 URL（为空则 recipes/ 作为普通目录随主仓库提交） */
+    subRepoUrl: string | undefined;
     /**
-     * @param {{ projectRoot: string, force?: boolean }} options
+     * @param {{ projectRoot: string, force?: boolean, seed?: boolean, subRepoDir?: string, subRepoUrl?: string }} options
      */
     constructor(options: {
         projectRoot: string;
         force?: boolean;
         seed?: boolean;
+        /** 自定义子仓库相对路径（默认 'AutoSnippet/recipes'） */
+        subRepoDir?: string;
+        /** 子仓库远程仓库 URL（提供则 clone，不提供则 recipes/ 为普通目录） */
+        subRepoUrl?: string;
     });
     getSteps(): ({
         label: string;
@@ -76,6 +88,8 @@ export declare class SetupService {
         fn: () => {
             coreInit: boolean;
             alreadyRepo: boolean;
+            subRepoPath: string;
+            hasUrl: boolean;
         };
     } | {
         label: string;
@@ -101,6 +115,8 @@ export declare class SetupService {
     stepCoreRepo(): {
         coreInit: boolean;
         alreadyRepo: boolean;
+        subRepoPath: string;
+        hasUrl: boolean;
     };
     /** @private 写入 constitution.yaml（优先从模板复制） */
     _writeConstitution(): void;
@@ -131,6 +147,54 @@ export declare class SetupService {
     _ensureEnvFile(): void;
     /** @private 在指定目录执行 git 命令 */
     _git(args: string[], cwd: string): string;
+    /** @private 检查目录中是否有文件（排除 . 和 ..） */
+    _hasFiles(dirPath: string): boolean;
+    /** @private 确保子仓库的 remote origin 与给定 URL 一致 */
+    _ensureRemote(url: string): void;
+    /**
+     * @private 备份已有文件 → clone → 合并回来（不覆盖远端文件）
+     * 适用于 recipes/ 有模板文件但还不是 git 仓库的场景
+     */
+    _cloneWithMerge(url: string): void;
+    /**
+     * 尝试初始化向量索引: 检查 embedding provider 可用性，
+     * 若可用则自动构建初始索引；否则提示用户手动运行 asd embed。
+     *
+     * 此步骤为 best-effort: 失败不阻塞 setup 流程。
+     */
+    stepVectorIndex(): Promise<{
+        status: string;
+        reason: string;
+        hint: string;
+        indexed?: undefined;
+        skipped?: undefined;
+        errors?: undefined;
+        error?: undefined;
+    } | {
+        status: string;
+        reason: string;
+        hint?: undefined;
+        indexed?: undefined;
+        skipped?: undefined;
+        errors?: undefined;
+        error?: undefined;
+    } | {
+        status: string;
+        indexed: number;
+        skipped: number;
+        errors: number;
+        reason?: undefined;
+        hint?: undefined;
+        error?: undefined;
+    } | {
+        status: string;
+        error: string;
+        hint: string;
+        reason?: undefined;
+        indexed?: undefined;
+        skipped?: undefined;
+        errors?: undefined;
+    }>;
 }
 export default SetupService;
 //# sourceMappingURL=SetupService.d.ts.map

package/dist/lib/cli/SetupService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SetupService.d.ts","sourceRoot":"","sources":["../../../lib/cli/SetupService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAcH,qBAAa,YAAY;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAQ;IAC5F,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;gBACS,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;IA4B7E,QAAQ;;;;;;;;;;;;;;;;;;;;IAUF,GAAG;cAEsB,MAAM;eAAS,MAAM;YAAM,OAAO;gBAAU,MAAM;;IAqBjF,4BAA4B;IAC5B,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAiBxD,YAAY;IAQZ,WAAW;;;IAkCX,YAAY;;;;IA+CZ,6CAA6C;IAC7C,kBAAkB;IAoDlB,+BAA+B;IAC/B,aAAa;IAuBb,0CAA0C;IAC1C,mBAAmB;IAanB,kCAAkC;IAClC,gBAAgB;IA2BhB,6BAA6B;IAC7B,gBAAgB;IAkFhB,OAAO;;;IAkBD,YAAY;;;IAsBlB;;;OAGG;IACG,gBAAgB,CAAC,EAAE,EAAE,OAAO;IAiB5B,YAAY;IA+BlB;;;OAGG;IACH,cAAc;IA0Bd,8BAA8B;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;CAcjC;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SetupService.d.ts","sourceRoot":"","sources":["../../../lib/cli/SetupService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AA6BH,qBAAa,YAAY;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAQ;IAC5F,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;gBACS,OAAO,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,2CAA2C;QAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iDAAiD;QACjD,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAiCD,QAAQ;;;;;;;;;;;;;;;;;;;;;;IAWF,GAAG;cAEsB,MAAM;eAAS,MAAM;YAAM,OAAO;gBAAU,MAAM;;IAqBjF,4BAA4B;IAC5B,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAiBxD,YAAY;IAQZ,WAAW;;;IAoCX,YAAY;;;;;;IA0EZ,6CAA6C;IAC7C,kBAAkB;IA0DlB,+BAA+B;IAC/B,aAAa;IAwBb,0CAA0C;IAC1C,mBAAmB;IAanB,kCAAkC;IAClC,gBAAgB;IA2BhB,6BAA6B;IAC7B,gBAAgB;IAiGhB,OAAO;;;IAkBD,YAAY;;;IAsBlB;;;OAGG;IACG,gBAAgB,CAAC,EAAE,EAAE,OAAO;IAiB5B,YAAY;IA+BlB;;;OAGG;IACH,cAAc;IA0Bd,8BAA8B;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;IAehC,qCAAqC;IACrC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASnC,+CAA+C;IAC/C,aAAa,CAAC,GAAG,EAAE,MAAM;IAYzB;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM;IA0C3B;;;;;OAKG;IACG,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDtB;AAED,eAAe,YAAY,CAAC"}

package/dist/lib/cli/SetupService.js

@@ -4,7 +4,7 @@
  * 一键初始化 AutoSnippet V2 工作空间，5 步完成：
  *
  *   Step 1  .autosnippet/ 运行时目录 + config.json + .gitignore
- *   Step 2  AutoSnippet/ 子仓库（核心数据 + 权限能力 + skills/）
+ *   Step 2  AutoSnippet/ 知识库目录结构 + AutoSnippet/recipes/（有 --repo 则 clone，无则为普通目录）
  *   Step 3  IDE 集成（VSCode MCP + Cursor MCP + copilot-instructions + cursor-rules
  *           + skills-template + cursor-workflow + claude-hooks + guard-ci + pre-commit-hook）
  *   Step 4  SQLite 数据库 + V1 数据迁移
@@ -14,15 +14,17 @@
  *
  * 数据架构（核心数据在子仓库，受 git 权限保护）
  * ─────────────────────────────────────────────
- *   AutoSnippet/  (Git 子仓库 = 唯一真实来源 Source of Truth)
+ *   AutoSnippet/  (知识库根目录)
  *     ├─ constitution.yaml    权限宪法：角色 + 权限矩阵 + 治理规则 + 能力探测
  *     ├─ boxspec.json         项目规格定义
- *     ├─ recipes/*.md         统一知识实体（代码规范/模式/架构/调用链/数据流/...）
- *     ├─ skills/             Project Skills（冷启动自动生成 + 手动创建）
+ *     ├─ recipes/             Git 子仓库 = 唯一真实来源 Source of Truth
+ *     │   └─ *.md             统一知识实体（代码规范/模式/架构/调用链/数据流/...）
+ *     ├─ candidates/          候选知识（待审批）
+ *     ├─ skills/              Project Skills（冷启动自动生成 + 手动创建）
  *     └─ README.md
  *
  *   .autosnippet/  (运行时缓存，gitignored)
- *     ├─ config.json          项目配置
+ *     ├─ config.json          项目配置（含 core.subRepoDir 子仓库路径）
  *     ├─ autosnippet.db       SQLite 运行时缓存（从子仓库同步 + candidates/snippets/audit）
  *     ├─ context/             向量索引缓存
  *     └─ logs/                运行日志
@@ -42,9 +44,10 @@
  *   子仓库 git 权限只是"一种能力（capability）"，最终裁决权在 Constitution YAML。
  */
 import { execSync } from 'node:child_process';
-import { copyFileSync, existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import { copyFileSync, cpSync, existsSync, mkdirSync, readdirSync, renameSync, rmdirSync, rmSync, writeFileSync, } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { isAutoSnippetDevRepo } from '../shared/isOwnDevRepo.js';
+import { DEFAULT_KNOWLEDGE_BASE_DIR, DEFAULT_SUB_REPO_DIR, isGitRepo, } from '../shared/ProjectMarkers.js';
 import { PACKAGE_ROOT } from '../shared/package-root.js';
 import { FileDeployer } from './deploy/FileDeployer.js';
 /** AutoSnippet 源码仓库根目录（定位 templates/ 等资源） */
@@ -62,14 +65,22 @@ export class SetupService {
     runtimeDir;
     seed;
     skillsDir;
+    /** 子仓库相对路径（相对于 projectRoot），如 'AutoSnippet/recipes' */
+    subRepoDir;
+    /** 子仓库绝对路径 */
+    subRepoPath;
+    /** 子仓库远程仓库 URL（为空则 recipes/ 作为普通目录随主仓库提交） */
+    subRepoUrl;
     /**
-     * @param {{ projectRoot: string, force?: boolean }} options
+     * @param {{ projectRoot: string, force?: boolean, seed?: boolean, subRepoDir?: string, subRepoUrl?: string }} options
      */
     constructor(options) {
         this.projectRoot = resolve(options.projectRoot);
         this.projectName = this.projectRoot.split('/').pop() || '';
         this.force = options.force || false;
         this.seed = options.seed || false;
+        this.subRepoDir = options.subRepoDir || DEFAULT_SUB_REPO_DIR;
+        this.subRepoUrl = options.subRepoUrl;
         // ── 开发仓库保护 ──────────────────────────────────
         if (isAutoSnippetDevRepo(this.projectRoot)) {
             throw new Error('[SetupService] 检测到当前目录是 AutoSnippet 源码开发仓库，' +
@@ -79,20 +90,23 @@ export class SetupService {
         // 运行时目录（gitignored）
         this.runtimeDir = join(this.projectRoot, '.autosnippet');
         this.dbPath = join(this.runtimeDir, 'autosnippet.db');
-        // 核心数据目录（子仓库）
-        this.coreDir = join(this.projectRoot, 'AutoSnippet');
+        // 知识库根目录
+        this.coreDir = join(this.projectRoot, DEFAULT_KNOWLEDGE_BASE_DIR);
         this.recipesDir = join(this.coreDir, 'recipes');
         this.candidatesDir = join(this.coreDir, 'candidates');
         this.skillsDir = join(this.coreDir, 'skills');
+        // 子仓库绝对路径
+        this.subRepoPath = join(this.projectRoot, this.subRepoDir);
     }
     /* ═══ 公共入口 ═══════════════════════════════════════ */
     getSteps() {
         return [
             { label: '创建运行时目录与配置', fn: () => this.stepRuntime() },
-            { label: '初始化核心数据子仓库', fn: () => this.stepCoreRepo() },
+            { label: '初始化知识库与 recipes 子仓库', fn: () => this.stepCoreRepo() },
             { label: '配置 IDE 集成', fn: () => this.stepIDE() },
             { label: '初始化数据库', fn: () => this.stepDatabase() },
             { label: '平台相关初始化', fn: () => this.stepPlatform() },
+            { label: '初始化向量索引', fn: () => this.stepVectorIndex() },
         ];
     }
     async run() {
@@ -151,8 +165,10 @@ export class SetupService {
                 projectName: this.projectName,
                 database: this.dbPath,
                 core: {
-                    dir: 'AutoSnippet',
-                    constitution: 'AutoSnippet/constitution.yaml',
+                    dir: DEFAULT_KNOWLEDGE_BASE_DIR,
+                    constitution: `${DEFAULT_KNOWLEDGE_BASE_DIR}/constitution.yaml`,
+                    subRepoDir: this.subRepoDir,
+                    ...(this.subRepoUrl ? { subRepoUrl: this.subRepoUrl } : {}),
                 },
                 ai: { provider: process.env.ASD_AI_PROVIDER || 'auto' },
                 guard: { enabled: true },
@@ -168,20 +184,35 @@ export class SetupService {
         this._ensureEnvFile();
         return { created: 'runtime' };
     }
-    /* ═══ Step 2: 核心数据子仓库 ═════════════════════════ */
+    /* ═══ Step 2: 知识库目录 + recipes 子仓库 ═════════════ */
     stepCoreRepo() {
-        const coreGit = join(this.coreDir, '.git');
-        const alreadyRepo = existsSync(coreGit);
+        const alreadyRepo = isGitRepo(this.subRepoPath);
         // 创建目录结构
         for (const d of [this.coreDir, this.recipesDir, this.candidatesDir, this.skillsDir]) {
             mkdirSync(d, { recursive: true });
         }
-        // 初始化 git（如果还不是 git 仓库）
-        if (!alreadyRepo) {
-            this._git(['init'], this.coreDir);
-        }
-        else {
+        // ── 子仓库处理：有 URL → clone 模式；无 URL → 普通目录 ──
+        if (this.subRepoUrl) {
+            if (alreadyRepo) {
+                // 幂等：已是 git 仓库，确保 remote 一致
+                this._ensureRemote(this.subRepoUrl);
+            }
+            else if (this._hasFiles(this.subRepoPath)) {
+                // 有文件但不是 git 仓库 → 备份 + clone + 合并
+                this._cloneWithMerge(this.subRepoUrl);
+            }
+            else {
+                // 空目录 → 直接 clone（先移除空目录，git clone 需要目标不存在）
+                try {
+                    rmdirSync(this.subRepoPath);
+                }
+                catch {
+                    /* 目录可能不存在或不为空，忽略 */
+                }
+                this._git(['clone', this.subRepoUrl, this.subRepoPath], this.projectRoot);
+            }
         }
+        // else: 无 URL → recipes/ 是普通目录，随主仓库提交，不执行 git init
         // constitution.yaml — 权限宪法
         this._writeConstitution();
         // boxspec.json — 项目规格
@@ -194,17 +225,32 @@ export class SetupService {
         }
         // README.md
         this._writeCoreReadme();
-        // .gitignore（子仓库自身）
-        const giPath = join(this.coreDir, '.gitignore');
-        if (!existsSync(giPath)) {
-            writeFileSync(giPath, '.DS_Store\n*.swp\n');
+        // .gitignore（子仓库自身，仅在有 URL 即子仓库模式时写入）
+        if (this.subRepoUrl) {
+            const giPath = join(this.subRepoPath, '.gitignore');
+            if (!existsSync(giPath)) {
+                writeFileSync(giPath, '.DS_Store\n*.swp\n');
+            }
         }
-        // 初始提交
-        if (!alreadyRepo) {
-            this._git(['add', '.'], this.coreDir);
-            this._git(['commit', '-m', 'Init AutoSnippet knowledge base'], this.coreDir);
+        // clone 后可能写入了模板文件，提交它们（仅新 clone 时）
+        if (this.subRepoUrl && !alreadyRepo && isGitRepo(this.subRepoPath)) {
+            try {
+                const status = this._git(['status', '--porcelain'], this.subRepoPath);
+                if (status.trim().length > 0) {
+                    this._git(['add', '.'], this.subRepoPath);
+                    this._git(['commit', '-m', 'Add AutoSnippet template files'], this.subRepoPath);
+                }
+            }
+            catch {
+                /* clone 的空仓库首次 commit 可能无变更，忽略 */
+            }
         }
-        return { coreInit: true, alreadyRepo };
+        return {
+            coreInit: true,
+            alreadyRepo,
+            subRepoPath: this.subRepoDir,
+            hasUrl: Boolean(this.subRepoUrl),
+        };
     }
     /** @private 写入 constitution.yaml（优先从模板复制） */
     _writeConstitution() {
@@ -224,7 +270,7 @@ export class SetupService {
                 '',
                 'capabilities:',
                 '  git_write:',
-                '    description: "子仓库 git push 权限"',
+                '    description: "recipes 子仓库 git push 权限"',
                 '    probe: "git push --dry-run"',
                 '    no_subrepo: "allow"',
                 '    no_remote: "allow"',
@@ -245,6 +291,12 @@ export class SetupService {
                 '    name: "Developer"',
                 '    permissions: ["*"]',
                 '    requires_capability: ["git_write"]',
+                '  - id: "contributor"',
+                '    name: "Contributor"',
+                '    permissions: ["read:recipes", "read:candidates", "read:guard_rules", "read:audit_logs:self"]',
+                '  - id: "visitor"',
+                '    name: "Visitor"',
+                '    permissions: ["read:recipes", "read:guard_rules"]',
                 '  - id: "external_agent"',
                 '    name: "External Agent"',
                 '    permissions: ["read:recipes", "read:guard_rules", "create:candidates", "submit:knowledge"]',
@@ -266,8 +318,9 @@ export class SetupService {
             schemaVersion: 2,
             kind: 'root',
             root: true,
-            knowledgeBase: { dir: 'AutoSnippet' },
-            module: { rootDir: 'AutoSnippet' },
+            knowledgeBase: { dir: DEFAULT_KNOWLEDGE_BASE_DIR },
+            subRepo: { dir: this.subRepoDir },
+            module: { rootDir: DEFAULT_KNOWLEDGE_BASE_DIR },
         }, null, 2));
     }
     /** @private 复制 _template.md 到 recipes/ */
@@ -317,7 +370,7 @@ export class SetupService {
         writeFileSync(dest, [
             `# ${this.projectName} — AutoSnippet Knowledge Base`,
             '',
-            '此目录是项目的 **核心知识库**，通过 Git 子仓库管理，同时承载数据存储与权限控制。',
+            '此目录是项目的 **核心知识库**，`recipes/` 目录存放核心知识数据。',
             '',
             '## 目录结构',
             '',
@@ -325,11 +378,15 @@ export class SetupService {
             'AutoSnippet/',
             '├── constitution.yaml   权限宪法（角色 + 权限 + 治理规则 + 能力探测）',
             '├── boxspec.json        项目规格',
-            '├── recipes/            统一知识实体（Markdown + YAML front-matter）',
+            ...(this.subRepoUrl
+                ? [
+                    '├── recipes/            ★ 独立 Git 子仓库 — 统一知识实体（Source of Truth）',
+                    '│   ├── .git/           独立 git 仓库',
+                ]
+                : ['├── recipes/            ★ 知识目录 — 统一知识实体（Source of Truth）']),
             '│   ├── _template.md    格式参考',
-            '│   ├── naming-rules.md 代码规范示例',
-            '│   ├── mvvm-arch.md    架构模式示例',
             '│   └── ...             代码模式/调用链/数据流/约束/风格/...',
+            '├── candidates/         候选知识（待审批）',
             '├── skills/             Project Skills（冷启动自动生成 + 手动创建）',
             '│   └── <name>/SKILL.md AI Agent 知识增强文档',
             '└── README.md',
@@ -360,27 +417,38 @@ export class SetupService {
             '',
             '| 层级 | 机制 | 职责 |',
             '|------|------|------|',
-            '| ① 能力层 | `git push --dry-run` | 探测子仓库物理写权限 |',
+            '| ① 能力层 | `git push --dry-run` | 探测 recipes 子仓库物理写权限 |',
             '| ② 角色层 | `constitution.yaml` roles | 角色权限矩阵 (action:resource) |',
             '| ③ 治理层 | `constitution.yaml` priorities | 业务规则引擎 |',
             '',
             'git 权限只是"能力信号"，**最终裁决权在 Constitution YAML**。',
             '',
-            '## 团队使用',
-            '',
-            '```bash',
-            '# 方式 1: 添加远程仓库',
-            'cd AutoSnippet',
-            'git remote add origin <your-repo-url>',
-            '',
-            '# 方式 2: 使用 git submodule（推荐）',
-            'cd ..',
-            'rm -rf AutoSnippet',
-            'git submodule add <your-repo-url> AutoSnippet',
-            '```',
+            ...(this.subRepoUrl
+                ? [
+                    '## 团队协作',
+                    '',
+                    '团队成员克隆主仓库后，需额外获取 recipes 子仓库：',
+                    '',
+                    '```bash',
+                    '# 方式 A：git submodule（推荐，自动关联）',
+                    `git submodule add ${this.subRepoUrl} ${this.subRepoDir}`,
+                    '',
+                    '# 方式 B：独立 clone',
+                    `git clone ${this.subRepoUrl} ${this.subRepoDir}`,
+                    '```',
+                ]
+                : [
+                    '## Recipes 知识库',
+                    '',
+                    '`recipes/` 目录随主仓库提交。如需独立管理（团队权限控制），运行：',
+                    '',
+                    '```bash',
+                    'asd remote <your-recipes-repo-url>',
+                    '```',
+                ]),
             '',
             '> 运行时缓存（DB 索引、Candidates、Snippets、审计日志）在 `.autosnippet/autosnippet.db`。',
-            '> **核心数据的唯一真实来源是此目录中的文件**，DB 仅做缓存。修改 Recipe/Guard 规则必须通过 git。',
+            '> **核心数据的唯一真实来源是 `recipes/` 目录中的文件**，DB 仅做缓存。',
             '',
         ].join('\n'));
     }
@@ -505,6 +573,126 @@ export class SetupService {
             throw e;
         }
     }
+    /** @private 检查目录中是否有文件（排除 . 和 ..） */
+    _hasFiles(dirPath) {
+        try {
+            const entries = readdirSync(dirPath);
+            return entries.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** @private 确保子仓库的 remote origin 与给定 URL 一致 */
+    _ensureRemote(url) {
+        try {
+            const currentUrl = this._git(['remote', 'get-url', 'origin'], this.subRepoPath);
+            if (currentUrl !== url) {
+                this._git(['remote', 'set-url', 'origin', url], this.subRepoPath);
+            }
+        }
+        catch {
+            // 没有 origin remote → 添加
+            this._git(['remote', 'add', 'origin', url], this.subRepoPath);
+        }
+    }
+    /**
+     * @private 备份已有文件 → clone → 合并回来（不覆盖远端文件）
+     * 适用于 recipes/ 有模板文件但还不是 git 仓库的场景
+     */
+    _cloneWithMerge(url) {
+        const backupDir = `${this.subRepoPath}-backup-${Date.now()}`;
+        // 1. 备份
+        renameSync(this.subRepoPath, backupDir);
+        // 2. clone
+        try {
+            this._git(['clone', url, this.subRepoPath], this.projectRoot);
+        }
+        catch (err) {
+            // clone 失败 → 恢复备份
+            try {
+                renameSync(backupDir, this.subRepoPath);
+            }
+            catch {
+                /* 尽力恢复 */
+            }
+            throw err;
+        }
+        // 3. 合并备份文件到 clone 结果（不覆盖已有文件）
+        try {
+            const files = readdirSync(backupDir);
+            for (const file of files) {
+                const dest = join(this.subRepoPath, file);
+                if (!existsSync(dest)) {
+                    cpSync(join(backupDir, file), dest, { recursive: true });
+                }
+            }
+        }
+        catch {
+            /* 合并阶段出错不影响 clone 结果 */
+        }
+        // 4. 清理备份
+        try {
+            rmSync(backupDir, { recursive: true, force: true });
+        }
+        catch {
+            /* 清理失败不影响主流程 */
+        }
+    }
+    /* ═══ Step 6: 向量索引初始化 ═══════════════════════════ */
+    /**
+     * 尝试初始化向量索引: 检查 embedding provider 可用性，
+     * 若可用则自动构建初始索引；否则提示用户手动运行 asd embed。
+     *
+     * 此步骤为 best-effort: 失败不阻塞 setup 流程。
+     */
+    async stepVectorIndex() {
+        try {
+            const { getServiceContainer } = await import('../injection/ServiceContainer.js');
+            const container = getServiceContainer();
+            // 检查 VectorService 是否已注册
+            if (!container.services.vectorService) {
+                return {
+                    status: 'skipped',
+                    reason: 'vectorService 未注册（AI Provider 未配置或容器未完全初始化）',
+                    hint: '运行 `asd embed` 构建语义向量索引',
+                };
+            }
+            const vectorService = container.get('vectorService');
+            const stats = await vectorService.getStats();
+            // 如果 embedding provider 不可用，提示用户
+            if (!stats.embedProviderAvailable) {
+                return {
+                    status: 'skipped',
+                    reason: '未配置 AI API Key',
+                    hint: '配置 API Key 后运行 `asd embed` 启用语义搜索',
+                };
+            }
+            // 如果索引已有数据，跳过
+            if (stats.count > 0 && !this.force) {
+                return {
+                    status: 'skipped',
+                    reason: `向量索引已存在 (${stats.count} entries)`,
+                };
+            }
+            // 构建初始索引
+            const result = await vectorService.fullBuild({ force: this.force });
+            return {
+                status: 'done',
+                indexed: result.upserted ?? 0,
+                skipped: result.skipped ?? 0,
+                errors: result.errors ?? 0,
+            };
+        }
+        catch (err) {
+            // 向量初始化失败不阻塞 setup 流程
+            return {
+                status: 'warning',
+                error: err instanceof Error ? err.message : String(err),
+                hint: '运行 `asd embed` 手动构建向量索引',
+            };
+        }
+    }
 }
 export default SetupService;
 //# sourceMappingURL=SetupService.js.map