@zhuan-ai/zhuanspec 2.17.2 → 2.17.6

package/dist/cli/index.js

@@ -45,6 +45,7 @@ program
     .description('Initialize ZhuanSpec in your project')
     .option('--tools <tools>', toolsOptionDescription)
     .option('--business-direction <direction>', 'Business direction for fetching project architecture (e.g., oms, ass)')
+    .option('--domain <domain>', 'Primary domain code; enables domain mode: syncs specs/<domain>/zhuanspec/ and generates project.md via spec-service-architecture skill')
     .action(async (targetPath = '.', options) => {
     try {
         // Validate that the path is a valid directory
@@ -71,6 +72,7 @@ program
         const initCommand = new InitCommand({
             tools: options?.tools,
             businessDirection: options?.businessDirection,
+            domain: options?.domain,
         });
         await initCommand.execute(targetPath);
     }

package/dist/core/archive.js

@@ -511,6 +511,17 @@ export class ArchiveCommand {
         if (explicitDirection && explicitDirection.trim()) {
             return explicitDirection.trim().toLowerCase();
         }
+        // domain mode: read .domain meta file (takes priority over .business-direction)
+        const domainFilePath = path.join(zhuanspecDir, '.domain');
+        try {
+            const fromDomain = (await fs.readFile(domainFilePath, 'utf-8')).trim();
+            if (fromDomain) {
+                return fromDomain.toLowerCase();
+            }
+        }
+        catch {
+            // Not domain mode, continue.
+        }
         const directionFilePath = path.join(zhuanspecDir, '.business-direction');
         try {
             const fromFile = (await fs.readFile(directionFilePath, 'utf-8')).trim();

package/dist/core/init.d.ts

@@ -29,13 +29,22 @@ type InitCommandOptions = {
     prompt?: ToolSelectionPrompt;
     tools?: string;
     businessDirection?: string;
+    domain?: string;
 };
 export declare class InitCommand {
     private readonly prompt;
     private readonly toolsArg?;
     private businessDirection?;
+    private readonly domain?;
     constructor(options?: InitCommandOptions);
     execute(targetPath: string): Promise<void>;
+    /**
+     * Domain mode initialization: clone remote repo and sync specs/<domain>/zhuanspec/ to local.
+     * project.md is generated by the spec-service-architecture skill (injected as post-init instruction).
+     */
+    private executeDomainSync;
+    private generateDomainProjectMdPlaceholder;
+    private syncBusinessDirectionAssets;
     private validate;
     private getConfiguration;
     private getSelectedTools;

package/dist/core/init.js

@@ -269,10 +269,12 @@ export class InitCommand {
     prompt;
     toolsArg;
     businessDirection;
+    domain;
     constructor(options = {}) {
         this.prompt = options.prompt ?? ((config) => toolSelectionWizard(config));
         this.toolsArg = options.tools;
         this.businessDirection = options.businessDirection;
+        this.domain = options.domain?.trim().toLowerCase() || undefined;
     }
     async execute(targetPath) {
         const projectPath = path.resolve(targetPath);
@@ -308,63 +310,17 @@ export class InitCommand {
         }
         // Step 2: Select business direction and sync Claude assets BEFORE configureAITools
         // This ensures .claude directory is not deleted after slash commands are generated
-        await this.promptForBusinessDirection();
-        if (this.businessDirection) {
-            const directionMetaPath = path.join(zhuanspecPath, '.business-direction');
-            await FileSystemUtils.writeFile(directionMetaPath, `${this.businessDirection.toLowerCase()}\n`);
-            const archSpinner = this.startSpinner(`正在获取 ${this.businessDirection} 业务架构文档...`);
-            const architectureContent = await this.fetchArchitectureFile();
-            if (architectureContent) {
-                const projectMdPath = path.join(zhuanspecPath, 'project.md');
-                const projectMdExists = await FileSystemUtils.fileExists(projectMdPath);
-                await FileSystemUtils.writeFile(projectMdPath, architectureContent);
-                archSpinner.stopAndPersist({
-                    symbol: PALETTE.white('▌'),
-                    text: PALETTE.white(projectMdExists
-                        ? `已使用 ${this.businessDirection} 业务架构文档覆盖 project.md`
-                        : `已应用 ${this.businessDirection} 业务架构文档到 project.md`),
-                });
-            }
-            else {
-                archSpinner.stopAndPersist({
-                    symbol: PALETTE.midGray('▌'),
-                    text: PALETTE.midGray(`未找到 ${this.businessDirection} 业务架构文档，使用默认模板`),
-                });
-            }
-            const specTemplateSpinner = this.startSpinner(`正在同步 ${this.businessDirection} 业务规范模板...`);
-            const syncResult = this.syncBusinessSpecTemplate(zhuanspecPath);
-            if (syncResult.syncedSpecs || syncResult.syncedChanges || syncResult.syncedKnowledge) {
-                const syncedParts = [];
-                if (syncResult.syncedSpecs) {
-                    syncedParts.push('specs');
-                }
-                if (syncResult.syncedChanges) {
-                    syncedParts.push('changes');
-                }
-                if (syncResult.syncedKnowledge) {
-                    syncedParts.push('knowledge');
-                }
-                specTemplateSpinner.stopAndPersist({
-                    symbol: PALETTE.white('▌'),
-                    text: PALETTE.white(`已从远端模板同步 ${syncedParts.join('、')} 目录`),
-                });
-            }
-            else {
-                specTemplateSpinner.stopAndPersist({
-                    symbol: PALETTE.midGray('▌'),
-                    text: PALETTE.midGray(`未找到 ${this.businessDirection} 业务规范模板目录，保留默认模板`),
-                });
-            }
-            // Sync Claude assets BEFORE configureAITools to avoid deletion
-            const claudeAssetSpinner = this.startSpinner(`正在同步 ${this.businessDirection} 业务 Claude 规范资产...`);
-            const claudeAssetResult = this.syncBusinessClaudeAssets(projectPath);
-            const claudeMdText = this.describeClaudeAssetResult('CLAUDE.md', claudeAssetResult.claudeMd);
-            const dotClaudeText = this.describeClaudeAssetResult('.claude', claudeAssetResult.dotClaude);
-            claudeAssetSpinner.stopAndPersist({
-                symbol: PALETTE.white('▌'),
-                text: PALETTE.white(`Claude 规范资产同步完成：${claudeMdText}；${dotClaudeText}`),
-            });
+        if (this.domain) {
+            // Domain mode: use domain as business direction first, then let
+            // specs/<domain>/zhuanspec/ override same-path template files.
+            await this.executeDomainSync(projectPath, zhuanspecPath);
         }
+        else {
+            await this.promptForBusinessDirection();
+            if (this.businessDirection) {
+                await this.syncBusinessDirectionAssets(projectPath, zhuanspecPath);
+            }
+        } // end domain else
         // Step 3: Configure AI tools (after Claude assets sync to preserve generated files)
         const toolSpinner = this.startSpinner('正在配置 AI 工具...');
         const toolConfigResult = await this.configureAITools(projectPath, zhuanspecDir, config.aiTools);
@@ -377,6 +333,128 @@ export class InitCommand {
         // Success message
         this.displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode, toolConfigResult.rootStubStatus, toolConfigResult.claudeHookSummary);
     }
+    /**
+     * Domain mode initialization: clone remote repo and sync specs/<domain>/zhuanspec/ to local.
+     * project.md is generated by the spec-service-architecture skill (injected as post-init instruction).
+     */
+    async executeDomainSync(projectPath, zhuanspecPath) {
+        const domain = this.domain;
+        this.businessDirection = domain;
+        // Save domain code to .domain meta file (used by archive for push routing)
+        const domainMetaPath = path.join(zhuanspecPath, '.domain');
+        await FileSystemUtils.writeFile(domainMetaPath, `${domain}\n`);
+        await this.syncBusinessDirectionAssets(projectPath, zhuanspecPath);
+        const syncSpinner = this.startSpinner(`正在从远端同步 ${domain} 主领域模板（specs/${domain}/zhuanspec/）...`);
+        const tempDir = this.cloneRemoteArchitectureRepoToTemp();
+        if (!tempDir) {
+            syncSpinner.stopAndPersist({
+                symbol: PALETTE.midGray('▌'),
+                text: PALETTE.midGray(`克隆远端仓库失败，跳过 ${domain} 主领域模板同步`),
+            });
+        }
+        else {
+            try {
+                const remoteZhuanspecDir = path.join(tempDir, 'specs', domain, 'zhuanspec');
+                if (!existsSync(remoteZhuanspecDir)) {
+                    syncSpinner.stopAndPersist({
+                        symbol: PALETTE.midGray('▌'),
+                        text: PALETTE.midGray(`远端未找到 specs/${domain}/zhuanspec/ 目录，跳过模板同步`),
+                    });
+                }
+                else {
+                    // Sync all contents from specs/<domain>/zhuanspec/ into local zhuanspec/
+                    this.copyDirectoryContentsIfExists(remoteZhuanspecDir, zhuanspecPath);
+                    syncSpinner.stopAndPersist({
+                        symbol: PALETTE.white('▌'),
+                        text: PALETTE.white(`已从远端 specs/${domain}/zhuanspec/ 同步模板到本地 zhuanspec/`),
+                    });
+                }
+            }
+            finally {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        }
+        // project.md is generated by spec-service-architecture skill after init
+        // Write a placeholder so Claude knows to invoke the skill
+        const projectMdPath = path.join(zhuanspecPath, 'project.md');
+        if (!(await FileSystemUtils.fileExists(projectMdPath))) {
+            await this.generateDomainProjectMdPlaceholder(projectMdPath, domain);
+        }
+        // Remind user to run spec-service-architecture skill to generate project.md
+        console.log();
+        console.log(PALETTE.white('domain 模式提示'));
+        console.log(PALETTE.lightGray(`  project.md 需由 @spec-service-architecture skill 生成，请在 AI 工具中执行：`));
+        console.log(PALETTE.midGray(`  /spec-service-architecture`));
+        console.log(PALETTE.midGray(`  生成完成后，文件将保存为 zhuanspec/project.md`));
+    }
+    async generateDomainProjectMdPlaceholder(projectMdPath, domain) {
+        const placeholder = `# Project Architecture
+
+<!-- 此文件由 domain 模式初始化，需通过 @spec-service-architecture skill 生成完整内容 -->
+<!-- domain: ${domain} -->
+<!-- 请在 AI 工具中执行 /spec-service-architecture，生成结果将覆盖此文件 -->
+`;
+        await FileSystemUtils.writeFile(projectMdPath, placeholder);
+    }
+    async syncBusinessDirectionAssets(projectPath, zhuanspecPath) {
+        if (!this.businessDirection) {
+            return;
+        }
+        const directionMetaPath = path.join(zhuanspecPath, '.business-direction');
+        await FileSystemUtils.writeFile(directionMetaPath, `${this.businessDirection.toLowerCase()}\n`);
+        const archSpinner = this.startSpinner(`正在获取 ${this.businessDirection} 业务架构文档...`);
+        const architectureContent = await this.fetchArchitectureFile();
+        if (architectureContent) {
+            const projectMdPath = path.join(zhuanspecPath, 'project.md');
+            const projectMdExists = await FileSystemUtils.fileExists(projectMdPath);
+            await FileSystemUtils.writeFile(projectMdPath, architectureContent);
+            archSpinner.stopAndPersist({
+                symbol: PALETTE.white('▌'),
+                text: PALETTE.white(projectMdExists
+                    ? `已使用 ${this.businessDirection} 业务架构文档覆盖 project.md`
+                    : `已应用 ${this.businessDirection} 业务架构文档到 project.md`),
+            });
+        }
+        else {
+            archSpinner.stopAndPersist({
+                symbol: PALETTE.midGray('▌'),
+                text: PALETTE.midGray(`未找到 ${this.businessDirection} 业务架构文档，使用默认模板`),
+            });
+        }
+        const specTemplateSpinner = this.startSpinner(`正在同步 ${this.businessDirection} 业务规范模板...`);
+        const syncResult = this.syncBusinessSpecTemplate(zhuanspecPath);
+        if (syncResult.syncedSpecs || syncResult.syncedChanges || syncResult.syncedKnowledge) {
+            const syncedParts = [];
+            if (syncResult.syncedSpecs) {
+                syncedParts.push('specs');
+            }
+            if (syncResult.syncedChanges) {
+                syncedParts.push('changes');
+            }
+            if (syncResult.syncedKnowledge) {
+                syncedParts.push('knowledge');
+            }
+            specTemplateSpinner.stopAndPersist({
+                symbol: PALETTE.white('▌'),
+                text: PALETTE.white(`已从远端模板同步 ${syncedParts.join('、')} 目录`),
+            });
+        }
+        else {
+            specTemplateSpinner.stopAndPersist({
+                symbol: PALETTE.midGray('▌'),
+                text: PALETTE.midGray(`未找到 ${this.businessDirection} 业务规范模板目录，保留默认模板`),
+            });
+        }
+        // Sync Claude assets BEFORE configureAITools to avoid deletion
+        const claudeAssetSpinner = this.startSpinner(`正在同步 ${this.businessDirection} 业务 Claude 规范资产...`);
+        const claudeAssetResult = this.syncBusinessClaudeAssets(projectPath);
+        const claudeMdText = this.describeClaudeAssetResult('CLAUDE.md', claudeAssetResult.claudeMd);
+        const dotClaudeText = this.describeClaudeAssetResult('.claude', claudeAssetResult.dotClaude);
+        claudeAssetSpinner.stopAndPersist({
+            symbol: PALETTE.white('▌'),
+            text: PALETTE.white(`Claude 规范资产同步完成：${claudeMdText}；${dotClaudeText}`),
+        });
+    }
     async validate(projectPath, _zhuanspecPath) {
         const extendMode = await FileSystemUtils.directoryExists(_zhuanspecPath);
         // Check write permissions

package/dist/core/templates/slash-command-templates.js

@@ -893,26 +893,9 @@ const designSteps = `**步骤**
      * 在 progress.json 的 events 字段追加：\`{ "event": "test-case-skipped", "timestamp": "<ISO>" }\`
      * 直接进入步骤 8
 
-7.6. **涉及工程清单输出（阶段 6 定稿产物，必须生成）**：
-   - 在技术方案定稿时，从 Skill 生成的 \`tech-spec.md\`、\`matched_services\` 和改动点定位结果中提取涉及工程
-   - 输出到与技术方案同目录：
-     \`zhuanspec/changes/{change-id}/techDesign/affected-projects.md\`
-   - 只记录分析出的工程/服务名称，不展开改动原因、证据、置信度或实现细节
-   - 固定使用 Markdown 列表：
-     \`\`\`markdown
-     # 涉及工程清单
-
-     - user-service
-     - order-service
-     \`\`\`
-   - 工程/服务必须来自项目知识定位或实际代码检索证据，禁止凭空补全
-   - 如果无法定位任何工程，也必须生成 \`affected-projects.md\`，并写明"未定位到明确工程"
-   - 该文件供后续 proposal/tasks/apply 阶段快速判断工程边界，禁止创建 proposal.md 或 tasks.md 来替代它
-
 8. **输出摘要**：
    - 告知用户生成的文档路径和实际调用的 Skill 名称
-   - 告知用户涉及工程清单路径：\`zhuanspec/changes/{change-id}/techDesign/affected-projects.md\`
-   - **明确说明**：techDesign 阶段仅保存进度数据（progress.json）、技术方案（含外部依赖矩阵）和涉及工程清单，不创建 proposal.md 和 tasks.md
+   - **明确说明**：techDesign 阶段仅保存进度数据（progress.json）和技术方案（含外部依赖矩阵），不创建 proposal.md 和 tasks.md
    - 如果步骤 7.5 生成了测试 case，额外提示：「✅ 已生成测试 case 源文件，后续 Propose 阶段将自动启用 TDD 模式并调用 tdd-testcase-generator 转换为研发 TDD testcase」
    - 提示 phase=techDesign
    - 提示下一步可以使用 \`/zhuanspec:proposal\` 创建变更提案（复用目录）`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuan-ai/zhuanspec",
-  "version": "2.17.2",
+  "version": "2.17.6",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "zhuanspec",
@@ -39,6 +39,26 @@
     "!dist/**/__tests__",
     "!dist/**/*.map"
   ],
+  "scripts": {
+    "lint": "eslint src/",
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "dev:cli": "pnpm build && node bin/zhuanspec.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "test:postinstall": "node scripts/postinstall.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/postinstall.js",
+    "check:pack-version": "node scripts/pack-version-check.mjs",
+    "diagnose:cursor": "node scripts/diagnose-cursor-commands.js",
+    "release": "pnpm run release:ci",
+    "release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",
+    "release:local": "pnpm exec changeset version && pnpm run check:pack-version && pnpm exec changeset publish",
+    "changeset": "changeset"
+  },
   "engines": {
     "node": ">=20.19.0"
   },
@@ -60,23 +80,5 @@
     "ora": "^8.2.0",
     "yaml": "^2.8.2",
     "zod": "^4.0.17"
-  },
-  "scripts": {
-    "lint": "eslint src/",
-    "build": "node build.js",
-    "dev": "tsc --watch",
-    "dev:cli": "pnpm build && node bin/zhuanspec.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
-    "test:postinstall": "node scripts/postinstall.js",
-    "postinstall": "node scripts/postinstall.js",
-    "check:pack-version": "node scripts/pack-version-check.mjs",
-    "diagnose:cursor": "node scripts/diagnose-cursor-commands.js",
-    "release": "pnpm run release:ci",
-    "release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",
-    "release:local": "pnpm exec changeset version && pnpm run check:pack-version && pnpm exec changeset publish",
-    "changeset": "changeset"
   }
-}
+}