@zhuan-ai/zhuanspec 2.17.1 → 2.17.5

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,21 @@ 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 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,69 @@ 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 (this.domain) {
+            // Domain mode: skip business direction prompt, sync from specs/<domain>/zhuanspec/
+            await this.executeDomainSync(projectPath, zhuanspecPath);
+        }
+        else {
+            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`),
+                    });
                 }
-                if (syncResult.syncedChanges) {
-                    syncedParts.push('changes');
+                else {
+                    archSpinner.stopAndPersist({
+                        symbol: PALETTE.midGray('▌'),
+                        text: PALETTE.midGray(`未找到 ${this.businessDirection} 业务架构文档，使用默认模板`),
+                    });
                 }
-                if (syncResult.syncedKnowledge) {
-                    syncedParts.push('knowledge');
+                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} 业务规范模板目录，保留默认模板`),
+                    });
                 }
-                specTemplateSpinner.stopAndPersist({
+                // 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(`已从远端模板同步 ${syncedParts.join('、')} 目录`),
-                });
-            }
-            else {
-                specTemplateSpinner.stopAndPersist({
-                    symbol: PALETTE.midGray('▌'),
-                    text: PALETTE.midGray(`未找到 ${this.businessDirection} 业务规范模板目录，保留默认模板`),
+                    text: PALETTE.white(`Claude 规范资产同步完成：${claudeMdText}；${dotClaudeText}`),
                 });
             }
-            // 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}`),
-            });
-        }
+        } // 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 +385,76 @@ 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;
+        // 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`);
+        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);
+        }
+        // Sync Claude assets from common
+        const claudeAssetSpinner = this.startSpinner('正在同步 Claude 规范资产（common）...');
+        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}`),
+        });
+        // 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 validate(projectPath, _zhuanspecPath) {
         const extendMode = await FileSystemUtils.directoryExists(_zhuanspecPath);
         // Check write permissions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuan-ai/zhuanspec",
-  "version": "2.17.1",
+  "version": "2.17.5",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "zhuanspec",