@zhuan-ai/zhuanspec 2.17.15 → 2.19.1

package/dist/cli/index.js

@@ -1,4 +1,4 @@
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 import { createRequire } from 'module';
 import ora from 'ora';
 import path from 'path';
@@ -104,8 +104,9 @@ const registerTechDesignCommand = (commandName, deprecatedAlias = false) => prog
     : 'Prepare technical design generation request (techDesign phase, independent before proposal by default)')
     .option('--change <change-id>', 'Optionally bind generated design source to a change')
     .option('--desc <text>', 'Requirement description used for technical design generation')
-    .option('--dashen-page-id <id>', 'Dashen pageId used as requirement source')
-    .option('--dashen-url <url>', 'Dashen document URL used as requirement source')
+    .option('--feishu-url <url>', 'Feishu document URL used as requirement source')
+    .addOption(new Option('--dashen-page-id <id>', 'Legacy pageId used as requirement source').hideHelp())
+    .addOption(new Option('--dashen-url <url>', 'Legacy document URL used as requirement source').hideHelp())
     .option('--output <path>', 'Output path of generated request markdown (default: doc/*技术方案生成请求.md)')
     .option('--init-template', 'Generate empty design.md template inside a change (legacy mode)')
     .option('--force', 'Overwrite existing output file or bound design.md')
@@ -117,7 +118,11 @@ const registerTechDesignCommand = (commandName, deprecatedAlias = false) => prog
             console.error('Warning: "zhuanspec design" is deprecated. Please use "zhuanspec techDesign".');
         }
         const designCommand = new DesignCommand();
-        await designCommand.execute(changeName, options);
+        await designCommand.execute(changeName, {
+            ...options,
+            legacyPageId: options?.dashenPageId,
+            legacyUrl: options?.dashenUrl,
+        });
     }
     catch (error) {
         console.log();

package/dist/commands/artifact-workflow.js

@@ -13,7 +13,7 @@ import { createChange, validateChangeName } from '../utils/change-utils.js';
 import { discoverSkills } from '../core/skill-discovery.js';
 import { getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getSyncSpecsSkillTemplate, getArchiveChangeSkillTemplate, getProposeChangeSkillTemplate, getExploreSkillTemplate, getVerifySkillTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxProposeCommandTemplate, getOpsxExploreCommandTemplate, getOpsxVerifyCommandTemplate } from '../core/templates/skill-templates.js';
 import { FileSystemUtils } from '../utils/file-system.js';
-import { parseTasks, generateExecutionPlan, renderExecutionPlanXml, renderMermaidDiagram, hasDependsAnnotations, } from '../core/task-graph/index.js';
+import { parseTasks, generateExecutionPlan, renderExecutionPlanXml, hasDependsAnnotations, } from '../core/task-graph/index.js';
 const DEFAULT_SCHEMA = 'spec-driven';
 /**
  * Checks if color output is disabled via NO_COLOR env or --no-color flag.
@@ -427,26 +427,6 @@ async function generateApplyInstructions(projectRoot, changeName, schemaName) {
             if (hasDependencies && !allTasksComplete) {
                 const executionPlan = generateExecutionPlan(parsedTasks);
                 executionPlanXml = renderExecutionPlanXml(executionPlan);
-                // Generate Mermaid diagram and embed in tasks.md
-                if (executionPlan && !executionPlan.hasCycle) {
-                    const mermaidSection = renderMermaidDiagram(executionPlan, parsedTasks);
-                    if (mermaidSection) {
-                        // Read current tasks.md content
-                        let currentTasksContent = tasksContent;
-                        // Check if tasks.md already has Workflow Diagram section
-                        const workflowDiagramRegex = /## Workflow Diagram[\s\S]*?(?=\n## |$)/;
-                        if (workflowDiagramRegex.test(currentTasksContent)) {
-                            // Replace existing Workflow Diagram section
-                            currentTasksContent = currentTasksContent.replace(workflowDiagramRegex, mermaidSection);
-                        }
-                        else {
-                            // Append to file end
-                            currentTasksContent = currentTasksContent.trimEnd() + '\n\n' + mermaidSection;
-                        }
-                        // Write back to tasks.md
-                        fs.writeFileSync(tracksPath, currentTasksContent, 'utf-8');
-                    }
-                }
             }
         }
     }
@@ -475,17 +455,15 @@ async function generateApplyInstructions(projectRoot, changeName, schemaName) {
     }
     else if (tracksFile && remaining === 0 && total > 0) {
         state = 'all_done';
-        instruction = `All tasks are complete. Review should auto-run once after apply completion.
+        instruction = `All tasks are complete. Apply is finished.
 
 **Required Next Steps**
 
-1. Verify auto review report exists (\`metrics/review.json\`, \`metrics/tests.json\`)
-2. Ensure unit tests pass in the review report
-3. Ensure critical issues = 0
-4. If auto review failed/missing, run \`zhuanspec review ${changeName}\` manually
-5. Then continue to \`zhuanspec archive ${changeName}\`
+1. Run \`zhuanspec review ${changeName}\` to verify implementation quality
+2. Fix any review findings if needed
+3. Continue to \`zhuanspec archive ${changeName}\` after review passes
 
-Archive may be blocked if review/tests are missing or failed.`;
+Archive may be blocked if review results are missing or failed.`;
     }
     else if (!tracksFile) {
         // No tracking file (e.g., TDD schema) - ready to apply
@@ -588,16 +566,13 @@ function printApplyInstructionsText(instructions) {
     // Code review prompt for all_done state
     if (state === 'all_done') {
         console.log();
-        console.log('### 📋 Code Review (Auto + Required)');
+        console.log('### Next Step');
         console.log();
         console.log('All tasks are complete. You should now:');
         console.log();
-        console.log('1. Auto review is triggered once when all apply tasks complete');
-        console.log('2. Confirm `metrics/review.json` and `metrics/tests.json` exist');
-        console.log('3. Ensure review report is PASS with no critical issues');
-        console.log('4. Ensure unit tests pass');
-        console.log('5. If auto review failed/missing, run `zhuanspec review <change-id>` manually');
-        console.log('6. Then proceed to archive workflow');
+        console.log('1. Run `zhuanspec review <change-id>`');
+        console.log('2. Fix review findings if needed');
+        console.log('3. Then proceed to archive workflow');
     }
 }
 async function templatesCommand(options) {

package/dist/commands/design.d.ts

@@ -4,8 +4,9 @@ export declare class DesignCommand {
         initTemplate?: boolean;
         change?: string;
         desc?: string;
-        dashenPageId?: string;
-        dashenUrl?: string;
+        feishuUrl?: string;
+        legacyPageId?: string;
+        legacyUrl?: string;
         output?: string;
         validate?: boolean;
         autoFix?: boolean;

package/dist/commands/design.js

@@ -49,8 +49,9 @@ export class DesignCommand {
         if (options?.createChange && !boundChange) {
             const designContext = await this.resolveDesignContext({
                 desc: options?.desc,
-                dashenPageId: options?.dashenPageId,
-                dashenUrl: options?.dashenUrl,
+                feishuUrl: options?.feishuUrl,
+                legacyPageId: options?.legacyPageId,
+                legacyUrl: options?.legacyUrl,
             });
             const newChangeName = await this.generateChangeName(designContext);
             await this.createTechDesignChange(newChangeName, designContext);
@@ -76,11 +77,12 @@ export class DesignCommand {
         }
         const designContext = await this.resolveDesignContext({
             desc: options?.desc,
-            dashenPageId: options?.dashenPageId,
-            dashenUrl: options?.dashenUrl,
+            feishuUrl: options?.feishuUrl,
+            legacyPageId: options?.legacyPageId,
+            legacyUrl: options?.legacyUrl,
         });
-        if (!designContext.desc && !designContext.dashenPageId && !designContext.dashenUrl) {
-            throw new Error('Missing design source. Provide --desc / --dashen-page-id / --dashen-url to generate technical design.');
+        if (!designContext.desc && !designContext.feishuUrl && !designContext.legacyPageId && !designContext.legacyUrl) {
+            throw new Error('Missing design source. Provide --desc or --feishu-url to generate technical design.');
         }
         const outputPath = await this.resolveOutputPath(options?.output, boundChange);
         const exists = await FileSystemUtils.fileExists(outputPath);
@@ -112,15 +114,16 @@ export class DesignCommand {
     async resolveDesignContext(input) {
         const result = {
             desc: input.desc?.trim() ?? '',
-            dashenPageId: input.dashenPageId?.trim() ?? '',
-            dashenUrl: input.dashenUrl?.trim() ?? '',
+            feishuUrl: input.feishuUrl?.trim() ?? '',
+            legacyPageId: input.legacyPageId?.trim() ?? '',
+            legacyUrl: input.legacyUrl?.trim() ?? '',
         };
-        if (result.desc || result.dashenPageId || result.dashenUrl || !process.stdin.isTTY) {
+        if (result.desc || result.feishuUrl || result.legacyPageId || result.legacyUrl || !process.stdin.isTTY) {
             return result;
         }
         const { input: askInput } = await import('@inquirer/prompts');
         const source = await askInput({
-            message: '请输入需求描述（或留空后继续输入 Dashen 信息）',
+            message: '请输入需求描述或飞书文档 URL（飞书文档将使用飞书 CLI 读取）',
             default: '',
         });
         result.desc = source.trim();
@@ -147,12 +150,12 @@ export class DesignCommand {
             '',
             '## 输入',
             `- 需求描述: ${context.desc || '(未提供)'}`,
-            `- Dashen Page ID: ${context.dashenPageId || '(未提供)'}`,
-            `- Dashen URL: ${context.dashenUrl || '(未提供)'}`,
+            `- 飞书文档 URL: ${context.feishuUrl || context.legacyUrl || '(未提供)'}`,
+            '- 飞书读取方式: 使用飞书 CLI `lark-cli` 读取正文',
             `- 绑定变更: ${boundChange || '(无，独立于提案阶段)'}`,
             '',
             '## 生成要求',
-            '- 使用 Dashen 模板优先，本地模板兜底',
+            '- 使用飞书文档内容作为需求来源，本地输入兜底',
             '- 输出完整技术方案（含 Mermaid）',
             '- 覆盖需求功能点并附带校验结果与修复记录',
             '',
@@ -346,12 +349,17 @@ export class DesignCommand {
         if (context.desc) {
             base = context.desc;
         }
-        else if (context.dashenPageId) {
-            base = `tech-design-${context.dashenPageId}`;
+        else if (context.feishuUrl) {
+            const docMatch = context.feishuUrl.match(/(?:docx|wiki)\/([^/?#]+)/);
+            const storyMatch = context.feishuUrl.match(/story\/detail\/([^/?#]+)/);
+            base = `tech-design-${docMatch?.[1] || storyMatch?.[1] || Date.now()}`;
         }
-        else if (context.dashenUrl) {
+        else if (context.legacyPageId) {
+            base = `tech-design-${context.legacyPageId}`;
+        }
+        else if (context.legacyUrl) {
             // Extract page ID from URL if possible
-            const match = context.dashenUrl.match(/pages\/(\d+)/);
+            const match = context.legacyUrl.match(/pages\/(\d+)/);
             base = match ? `tech-design-${match[1]}` : `tech-design-${Date.now()}`;
         }
         else {
@@ -391,9 +399,9 @@ export class DesignCommand {
         // 3. Create techDesign/ directory and tech-spec.md placeholder
         const techDesignDir = path.join(changeDir, 'techDesign');
         await FileSystemUtils.createDirectory(techDesignDir);
-        await FileSystemUtils.writeFile(path.join(techDesignDir, 'tech-spec.md'), `# Tech Spec\n\ncreated: ${new Date().toISOString()}\nsource: ${context.desc || context.dashenPageId || 'manual'}\n\n> This file will be populated by the techDesign skill.\n`);
+        await FileSystemUtils.writeFile(path.join(techDesignDir, 'tech-spec.md'), `# Tech Spec\n\ncreated: ${new Date().toISOString()}\nsource: ${context.desc || context.feishuUrl || context.legacyPageId || 'manual'}\n\n> This file will be populated by the techDesign skill.\n`);
         // 3b. Also create .tech-design marker for backward compatibility
-        await FileSystemUtils.writeFile(path.join(changeDir, '.tech-design'), `created: ${new Date().toISOString()}\nsource: ${context.desc || context.dashenPageId || 'manual'}\n`);
+        await FileSystemUtils.writeFile(path.join(changeDir, '.tech-design'), `created: ${new Date().toISOString()}\nsource: ${context.desc || context.feishuUrl || context.legacyPageId || 'manual'}\n`);
         // 4. Create design.md skeleton
         await FileSystemUtils.writeFile(path.join(changeDir, 'design.md'), DEFAULT_DESIGN_TEMPLATE);
         // 5. Create doc/ request file (keep compatibility)

package/dist/core/completions/command-registry.js

@@ -86,13 +86,8 @@ export const COMMAND_REGISTRY = [
                 takesValue: true,
             },
             {
-                name: 'dashen-page-id',
-                description: 'Dashen pageId used as requirement source',
-                takesValue: true,
-            },
-            {
-                name: 'dashen-url',
-                description: 'Dashen document URL used as requirement source',
+                name: 'feishu-url',
+                description: 'Feishu document URL used as requirement source',
                 takesValue: true,
             },
             {

package/dist/core/configurators/slash/auggie.js

@@ -14,7 +14,7 @@ argument-hint: feature description or request
 ---`,
     design: `---
 description: 在 proposal 之前独立生成技术设计请求文档。
-argument-hint: dashen-page-id or description
+argument-hint: feishu-url or description
 ---`,
     apply: `---
 description: 实施已批准的 ZhuanSpec 变更并保持任务同步。

package/dist/core/configurators/slash/costrict.js

@@ -14,7 +14,7 @@ argument-hint: feature description or request
 ---`,
     design: `---
 description: "在 proposal 之前独立生成技术设计请求文档。"
-argument-hint: dashen-page-id or description
+argument-hint: feishu-url or description
 ---`,
     apply: `---
 description: "实施已批准的 ZhuanSpec 变更并保持任务同步。"

package/dist/core/configurators/slash/factory.js

@@ -14,7 +14,7 @@ argument-hint: request or feature description
 ---`,
     design: `---
 description: 在 proposal 之前独立生成技术设计请求文档。
-argument-hint: dashen-page-id or description
+argument-hint: feishu-url or description
 ---`,
     apply: `---
 description: 实施已批准的 ZhuanSpec 变更并保持任务同步。

package/dist/core/hooks/init.js

@@ -200,8 +200,7 @@ async function runInitHook(_options) {
     const versionBanner = await checkVersionUpdate();
     // Build system message — intentionally minimal. Only the version banner
     // and active-change phase line are surfaced. Per-phase guidance lives in
-    // the corresponding Skill / slash-command template (e.g. zhuanspec-apply
-    // carries the subagent spawn authorization).
+    // the corresponding Skill / slash-command template.
     let systemMessage = '';
     if (versionBanner) {
         systemMessage += `${versionBanner}\n`;
@@ -220,7 +219,7 @@ async function runInitHook(_options) {
                 systemMessage += ` (run /zhuanspec:proposal to continue)`;
             }
             else if (phase === 'apply') {
-                systemMessage += ` (run zhuanspec-apply skill to execute Waves)`;
+                systemMessage += ` (run zhuanspec-apply to implement pending tasks)`;
             }
             systemMessage += `\n`;
         }

package/dist/core/hooks/post-apply.d.ts

@@ -3,7 +3,7 @@
  *
  * Actions after Apply phase completes:
  * 1. Reverse Sync deviation detection
- * 2. Report status (user manually triggers review in a new session)
+ * 2. Report status (user manually triggers review when ready)
  */
 interface PostApplyOptions {
     json?: boolean;
@@ -25,9 +25,8 @@ interface HookOutput {
 export declare function postApplyHook(options: PostApplyOptions): Promise<void>;
 /**
  * Execute post-apply actions: deviation detection only.
- * Auto review trigger has been removed to ensure Stop hook fires correctly
- * and apply phaseBaseline is properly marked.
- * Users should manually run `zhuanspec review <change-id>` in a new session.
+ * Auto review trigger has been removed so apply stays focused on implementation.
+ * Users should manually run `zhuanspec review <change-id>` when they want full validation.
  */
 export declare function executePostApply(changeDir: string, repoRoot: string): Promise<HookOutput>;
 export {};

package/dist/core/hooks/post-apply.js

@@ -3,7 +3,7 @@
  *
  * Actions after Apply phase completes:
  * 1. Reverse Sync deviation detection
- * 2. Report status (user manually triggers review in a new session)
+ * 2. Report status (user manually triggers review when ready)
  */
 import path from 'path';
 import { FileSystemUtils } from '../../utils/file-system.js';
@@ -40,9 +40,8 @@ async function runPostApplyHook(changeId) {
 }
 /**
  * Execute post-apply actions: deviation detection only.
- * Auto review trigger has been removed to ensure Stop hook fires correctly
- * and apply phaseBaseline is properly marked.
- * Users should manually run `zhuanspec review <change-id>` in a new session.
+ * Auto review trigger has been removed so apply stays focused on implementation.
+ * Users should manually run `zhuanspec review <change-id>` when they want full validation.
  */
 export async function executePostApply(changeDir, repoRoot) {
     // 0. Feature-omission gate（功能点遗漏闸口）：检测「范围内但未实现」的 Scenario/功能点
@@ -84,7 +83,7 @@ export async function executePostApply(changeDir, repoRoot) {
         }
         return {
             continue: true,
-            systemMessage: 'Post-apply: No deviation detected. Please run `zhuanspec review` in a new session to enter Review phase.',
+            systemMessage: 'Post-apply: No deviation detected. Please run `zhuanspec review` when you are ready to validate the change.',
             hookSpecificOutput: {
                 reviewTriggered: false,
                 deviationDetected: false,

package/dist/core/hooks/summarize.js

@@ -89,8 +89,7 @@ async function runSummarize() {
         }
     }
     // Deviation detection only (no auto review trigger).
-    // Apply 完成后不再自动触发 review，确保 Stop hook 正确闪断以标记 apply baseline。
-    // 用户需在新会话中手动执行 `zhuanspec review <change-id>` 进入 review 阶段。
+    // Apply 完成后不再自动触发 review；用户准备验收时再手动执行 `zhuanspec review <change-id>`。
     let deviationDetected = false;
     if (phase === 'apply' && allTasksComplete) {
         // Execute post-apply hook to detect deviations only

package/dist/core/task-graph/execution-planner.js

@@ -71,6 +71,7 @@ export function generateExecutionPlan(tasks, options) {
     // Create graph and validate
     const graph = new TaskGraph(incompleteTasks);
     const validation = graph.validate();
+    const taskById = new Map(incompleteTasks.map(task => [task.id, task]));
     // Check for cycles
     if (validation.errors.some(e => e.includes('Circular dependency'))) {
         return {
@@ -95,7 +96,7 @@ export function generateExecutionPlan(tasks, options) {
     // Initialize
     for (const task of incompleteTasks) {
         // Only count dependencies that exist in incomplete tasks
-        const validDeps = task.depends.filter(d => incompleteTasks.some(t => t.id === d));
+        const validDeps = task.depends.filter(d => taskById.has(d));
         inDegree.set(task.id, validDeps.length);
         dependents.set(task.id, []);
     }
@@ -120,7 +121,7 @@ export function generateExecutionPlan(tasks, options) {
             break;
         }
         const readyTasks = readyIds
-            .map(id => incompleteTasks.find(t => t.id === id))
+            .map(id => taskById.get(id))
             .filter(Boolean);
         waves.push({
             wave: waveNumber,