@zhuan-ai/zhuanspec 2.10.0 → 2.11.2

package/dist/cli/index.js

@@ -220,6 +220,7 @@ program
     .command('review [change-name]')
     .description('Run ZhuanSpec review and unit test verification')
     .option('--json', 'Output review report as JSON')
+    .option('--force', 'Skip task completion check and force review')
     .option('--test-command <command>', 'Test command to execute (default: npm test)')
     .option('--coverage-threshold <n>', 'Coverage threshold percentage (default: 80)')
     .action(async (changeName, options) => {

package/dist/commands/design.d.ts

@@ -18,13 +18,22 @@ export declare class DesignCommand {
     private bindDesignSourceToChange;
     private selectChangeInteractively;
     /**
-     * Validate design.md for required sections and optionally auto-fix
+     * Validate design.md for required sections and optionally auto-fix.
+     * Uses dynamic section derivation: always-required sections are checked for all proposals,
+     * while conditional sections are only required when techDesign/tech-spec.md content matches.
      */
     private validateDesign;
     /**
      * Auto-fix design content by adding missing section skeletons
      */
     private autoFixDesign;
+    /**
+     * Derive required design.md sections dynamically.
+     * Always-required: 背景/Background, 决策/Decision, 风险/Risks.
+     * Conditional sections are added based on techDesign/tech-spec.md content.
+     * When no techDesign directory exists, only always-required sections are enforced (backward compat).
+     */
+    private getRequiredSections;
     /**
      * Generate a kebab-case change name from design context
      */
@@ -32,7 +41,8 @@ export declare class DesignCommand {
     /**
      * Create a new change directory for techDesign phase
      * - Creates change directory using createChange()
-     * - Creates .tech-design marker file
+     * - Creates .tech-design marker file (backward compat)
+     * - Creates techDesign/ directory with tech-spec.md placeholder
      * - Initializes progress.json with phase=techDesign
      * - Creates design.md skeleton
      * - Creates doc/ request file

package/dist/commands/design.js

@@ -209,7 +209,9 @@ export class DesignCommand {
         }
     }
     /**
-     * Validate design.md for required sections and optionally auto-fix
+     * Validate design.md for required sections and optionally auto-fix.
+     * Uses dynamic section derivation: always-required sections are checked for all proposals,
+     * while conditional sections are only required when techDesign/tech-spec.md content matches.
      */
     async validateDesign(changeName, autoFix) {
         const changeDir = path.join(process.cwd(), 'zhuanspec', 'changes', changeName);
@@ -219,15 +221,8 @@ export class DesignCommand {
         }
         const content = await FileSystemUtils.readFile(designPath);
         const issues = [];
-        // Check required sections: 背景/目标/决策/风险
-        const requiredSections = [
-            { pattern: /^##\s+(背景|Background)/im, name: '背景/Background', skeleton: '## 背景\n\n[请补充背景、约束、利益相关者]\n' },
-            { pattern: /^##\s+(目标|Goals|非目标|Non-Goals)/im, name: '目标/Goals', skeleton: '## 目标 / 非目标\n\n- Goals: [...]\n- Non-Goals: [...]\n' },
-            { pattern: /^##\s+(决策|Decision)/im, name: '决策/Decision', skeleton: '## 决策\n\n- Decision: [内容和原因]\n- Alternatives considered: [选项 + 理由]\n' },
-            { pattern: /^##\s+(接口设计|Interface|API)/im, name: '接口设计/Interface', skeleton: '## 接口设计\n\n<!-- 接口签名、入参出参字段类型、枚举值、SCF 方法名 -->\n' },
-            { pattern: /^##\s+(实现细节|Implementation)/im, name: '实现细节/Implementation', skeleton: '## 实现细节\n\n<!-- 分层实现说明（Component→Application→Domain→Assemble→DAO）、关键逻辑、复用点 -->\n' },
-            { pattern: /^##\s+(风险|权衡|Risks)/im, name: '风险/Risks', skeleton: '## 风险 / 权衡\n\n- [风险] -> 缓解措施\n' },
-        ];
+        // Dynamically derive required sections based on techDesign content
+        const requiredSections = await this.getRequiredSections(changeDir);
         for (const section of requiredSections) {
             if (!section.pattern.test(content)) {
                 issues.push({
@@ -291,6 +286,58 @@ export class DesignCommand {
         }
         return result;
     }
+    /**
+     * Derive required design.md sections dynamically.
+     * Always-required: 背景/Background, 决策/Decision, 风险/Risks.
+     * Conditional sections are added based on techDesign/tech-spec.md content.
+     * When no techDesign directory exists, only always-required sections are enforced (backward compat).
+     */
+    async getRequiredSections(changePath) {
+        // Always-required sections for every proposal
+        const sections = [
+            { pattern: /^##\s+(背景|Background)/im, name: '背景/Background', skeleton: '## 背景\n\n[请补充背景、约束、利益相关者]\n' },
+            { pattern: /^##\s+(决策|Decision)/im, name: '决策/Decision', skeleton: '## 决策\n\n- Decision: [内容和原因]\n- Alternatives considered: [选项 + 理由]\n' },
+            { pattern: /^##\s+(风险|权衡|Risks)/im, name: '风险/Risks', skeleton: '## 风险 / 权衡\n\n- [风险] -> 缓解措施\n' },
+        ];
+        // Conditionally add sections based on tech-spec.md content
+        const techSpecPath = path.join(changePath, 'techDesign', 'tech-spec.md');
+        if (await FileSystemUtils.fileExists(techSpecPath)) {
+            const techContent = await fs.readFile(techSpecPath, 'utf-8');
+            // Tech spec has DDL / table creation → require Database Design
+            if (/CREATE\s+TABLE|DDL|建表|ALTER\s+TABLE/i.test(techContent)) {
+                sections.push({
+                    pattern: /^##\s+(数据模型|数据库设计|Database\s*Design)/im,
+                    name: '数据模型/Database Design',
+                    skeleton: '## 数据模型\n\n<!-- DB schema 变更、实体类字段、索引设计 -->\n',
+                });
+            }
+            // Tech spec has API / interface definitions → require API Contract
+            if (/接口|API|SCF|RPC|Controller|@RequestMapping/i.test(techContent)) {
+                sections.push({
+                    pattern: /^##\s+(接口设计|接口契约|API\s*Contract|Interface)/im,
+                    name: '接口设计/API Contract',
+                    skeleton: '## 接口设计\n\n<!-- 接口签名、入参出参字段类型、枚举值、SCF 方法名 -->\n',
+                });
+            }
+            // Tech spec has ES / MQ / Cache → require Infrastructure
+            if (/ElasticSearch|ES.*索引|mapping|MQ|RocketMQ|Consumer|Redis|缓存|Cache/i.test(techContent)) {
+                sections.push({
+                    pattern: /^##\s+(基础设施|Infrastructure)/im,
+                    name: '基础设施/Infrastructure',
+                    skeleton: '## 基础设施\n\n<!-- ES / MQ / Cache 等基础设施设计 -->\n',
+                });
+            }
+            // Tech spec has frontend design → require Frontend Design
+            if (/前端|页面|组件|路由|Frontend|Component|React|Vue/i.test(techContent)) {
+                sections.push({
+                    pattern: /^##\s+(前端设计|Frontend\s*Design)/im,
+                    name: '前端设计/Frontend Design',
+                    skeleton: '## 前端设计\n\n<!-- 页面布局、组件结构、路由设计 -->\n',
+                });
+            }
+        }
+        return sections;
+    }
     /**
      * Generate a kebab-case change name from design context
      */
@@ -328,7 +375,8 @@ export class DesignCommand {
     /**
      * Create a new change directory for techDesign phase
      * - Creates change directory using createChange()
-     * - Creates .tech-design marker file
+     * - Creates .tech-design marker file (backward compat)
+     * - Creates techDesign/ directory with tech-spec.md placeholder
      * - Initializes progress.json with phase=techDesign
      * - Creates design.md skeleton
      * - Creates doc/ request file
@@ -340,7 +388,11 @@ export class DesignCommand {
         const changeDir = path.join(projectRoot, 'zhuanspec', 'changes', changeName);
         // 2. Initialize progress.json with phase=techDesign
         await initializeProgress(changeName, 'techDesign');
-        // 3. Create .tech-design marker file
+        // 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`);
+        // 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`);
         // 4. Create design.md skeleton
         await FileSystemUtils.writeFile(path.join(changeDir, 'design.md'), DEFAULT_DESIGN_TEMPLATE);

package/dist/commands/progress.js

@@ -312,6 +312,17 @@ export class ProgressCommand {
         else if (completedCount === totalTasks && totalTasks > 0) {
             console.log('✅ 全部任务完成，准备进入 Review 阶段');
         }
+        // Proposal changes history
+        if (progress?.proposalChanges && progress.proposalChanges.length > 0) {
+            console.log('');
+            console.log('📝 提案修改历史:');
+            for (const change of progress.proposalChanges) {
+                console.log(`  [${change.timestamp}] ${change.triggeredBy} (${change.phase})${change.relatedDeviationId ? ` ← ${change.relatedDeviationId}` : ''}`);
+                for (const file of change.modifiedFiles) {
+                    console.log(`    ${file.changeType}: ${file.filePath} - ${file.summary}`);
+                }
+            }
+        }
     }
     generateProgressBar(percentage, blocks) {
         const filled = Math.round((percentage / 100) * blocks);

package/dist/commands/review.d.ts

@@ -1,6 +1,7 @@
 export declare class ReviewCommand {
     execute(changeName?: string, options?: {
         json?: boolean;
+        force?: boolean;
     }): Promise<void>;
     private selectChangeInteractively;
 }

package/dist/commands/review.js

@@ -22,6 +22,19 @@ export class ReviewCommand {
         if (!proposalExists || !tasksExists) {
             throw new Error(`Change '${changeName}' is not ready for review. Missing proposal.md or tasks.md`);
         }
+        // === Task completion hard gate ===
+        if (tasksExists) {
+            const tasksContent = await fs.readFile(tasksPath, 'utf-8');
+            const uncompletedTasks = tasksContent.match(/^- \[ \] .+$/gm) || [];
+            if (uncompletedTasks.length > 0 && !options?.force) {
+                throw new Error(`Change '${changeName}' has ${uncompletedTasks.length} uncompleted tasks. ` +
+                    `Please complete all tasks before review. Use --force to override.\n` +
+                    uncompletedTasks.map(t => `  ${t.trim()}`).join('\n'));
+            }
+            if (uncompletedTasks.length > 0 && options?.force) {
+                console.log(`⚠️ Force mode: skipping ${uncompletedTasks.length} uncompleted tasks`);
+            }
+        }
         // Check skill output JSON files exist
         const codeReviewJsonPath = path.join(reviewDir, 'code-review-result.json');
         const unitTestJsonPath = path.join(reviewDir, 'unit-test-result.json');

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

@@ -124,6 +124,10 @@ export const COMMAND_REGISTRY = [
         positionalType: 'change-id',
         flags: [
             COMMON_FLAGS.json,
+            {
+                name: 'force',
+                description: 'Skip task completion check and force review',
+            },
             {
                 name: 'test-command',
                 description: 'Test command to execute (default: npm test)',

package/dist/core/hooks/deviation-check.js

@@ -12,6 +12,7 @@
  *    - Out of scope → block with deviation handling options
  */
 import path from 'path';
+import fs from 'fs';
 import { FileSystemUtils } from '../../utils/file-system.js';
 import { GitRepoDetector } from '../../utils/git-repo-detector.js';
 import { checkPreApplyConditions } from './pre-apply.js';
@@ -148,6 +149,13 @@ async function runDeviationCheck(filePath, trigger, promptText, _options) {
             return !estimatedFiles.map(normalizePath).some((scope) => normalized.includes(scope) || scope.includes(normalized));
         });
         if (outOfScope.length > 0) {
+            const resumeDeviationId = `dev-resume-${Date.now()}`;
+            // Write deviation ID to temp file for record-progress to read (cross-process)
+            const metricsDir = path.join(changeDir, 'metrics');
+            if (!fs.existsSync(metricsDir)) {
+                fs.mkdirSync(metricsDir, { recursive: true });
+            }
+            fs.writeFileSync(path.join(metricsDir, '.last-deviation-id'), resumeDeviationId, 'utf-8');
             return {
                 continue: false,
                 stopReason: 'Resume deviation detected',
@@ -268,6 +276,34 @@ async function runDeviationCheck(filePath, trigger, promptText, _options) {
     }
     // Apply phase → check deviation
     if (phase === 'apply') {
+        // === Task completion gate for Apply→Review transition ===
+        if (trigger === 'post-prompt') {
+            const lowerPrompt = promptText.toLowerCase();
+            const reviewTransitionKeywords = [
+                'review', '审查', '进入review', 'review阶段', '代码审查',
+                'zhuanspec review', '/review', '开始review',
+            ];
+            const isReviewTransition = reviewTransitionKeywords.some(kw => lowerPrompt.includes(kw));
+            if (isReviewTransition && await FileSystemUtils.fileExists(tasksPath)) {
+                try {
+                    const tasksContent = await FileSystemUtils.readFile(tasksPath);
+                    const uncompleted = tasksContent.match(/^- \[ \] .+$/gm) || [];
+                    if (uncompleted.length > 0) {
+                        return {
+                            continue: false,
+                            stopReason: 'Task completion gate: uncompleted tasks block Review transition',
+                            systemMessage: `⚠️ BLOCKED: Cannot transition to Review — ${uncompleted.length} tasks uncompleted in tasks.md.\n\nUncompleted tasks:\n${uncompleted.map(t => `  ${t.trim()}`).join('\n')}\n\nPlease complete all tasks before entering Review, or use \`zhuanspec review <id> --force\` to override.`,
+                            hookSpecificOutput: {
+                                additionalContext: `Task completion gate blocked Apply→Review transition. ${uncompleted.length} uncompleted tasks found.`,
+                            },
+                        };
+                    }
+                }
+                catch {
+                    // If tasks.md read fails, allow transition
+                }
+            }
+        }
         let estimatedFiles = [];
         let currentTaskFiles = [];
         // Parse proposal for estimated changes
@@ -293,6 +329,12 @@ async function runDeviationCheck(filePath, trigger, promptText, _options) {
         }
         // File is out of scope → deviation detected
         const deviationId = `dev-${Date.now()}`;
+        // Write deviation ID to temp file for record-progress to read (cross-process)
+        const deviationMetricsDir = path.join(changeDir, 'metrics');
+        if (!fs.existsSync(deviationMetricsDir)) {
+            fs.mkdirSync(deviationMetricsDir, { recursive: true });
+        }
+        fs.writeFileSync(path.join(deviationMetricsDir, '.last-deviation-id'), deviationId, 'utf-8');
         return {
             continue: false,
             stopReason: 'Deviation detected: File not in approved proposal scope',

package/dist/core/hooks/init.js

@@ -36,6 +36,22 @@ async function checkVersionUpdate() {
         return null;
     }
 }
+async function updateClaudeHudCustomLine(versionBanner) {
+    const configDir = process.env.CLAUDE_CONFIG_DIR || path.join(process.env.HOME || '~', '.claude');
+    const hudConfigPath = path.join(configDir, 'plugins', 'claude-hud', 'config.json');
+    try {
+        const raw = await fs.promises.readFile(hudConfigPath, 'utf-8');
+        const config = JSON.parse(raw);
+        if (!config.display)
+            config.display = {};
+        config.display.customLine = versionBanner;
+        await fs.promises.writeFile(hudConfigPath, JSON.stringify(config, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 export async function initHook(options) {
     const startTime = Date.now();
     const output = await runInitHook(options);
@@ -56,6 +72,9 @@ export async function initHook(options) {
     catch {
         // Ignore write errors
     }
+    if (output.versionBanner) {
+        await updateClaudeHudCustomLine(output.versionBanner);
+    }
     if (options.json) {
         console.log(JSON.stringify(output));
     }
@@ -252,12 +271,10 @@ async function runInitHook(_options) {
         additionalContext += `(These are loaded automatically by Claude Code system)\n\n`;
     }
     const versionBanner = await checkVersionUpdate();
-    const finalMessage = versionBanner
-        ? versionBanner + '\n' + (systemMessage || '✓ ZhuanSpec session initialized')
-        : (systemMessage || '✓ ZhuanSpec session initialized');
     return {
         continue: true,
-        systemMessage: finalMessage,
+        systemMessage: systemMessage || '✓ ZhuanSpec session initialized',
+        versionBanner: versionBanner || undefined,
         hookSpecificOutput: {
             additionalContext: additionalContext || undefined,
             env: {

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

@@ -189,6 +189,7 @@ async function updateProgressJson(changeDir, event) {
                 reviewStats: { loopCount: 0, criticalFixes: 0, testFixes: 0, consistencyFixes: 0 },
                 phaseTransitions: [],
                 phaseDurations: [],
+                proposalChanges: [],
                 stats: { tokenUsageTotal: 0, contextLoad: 0, durationMs: { propose: 0, apply: 0, review: 0, archive: 0 } },
             };
         }
@@ -217,6 +218,7 @@ async function updateProgressJson(changeDir, event) {
             reviewStats: { loopCount: 0, criticalFixes: 0, testFixes: 0, consistencyFixes: 0 },
             phaseTransitions: [],
             phaseDurations: [],
+            proposalChanges: [],
             stats: { tokenUsageTotal: 0, contextLoad: 0, durationMs: { propose: 0, apply: 0, review: 0, archive: 0 } },
         };
     }

package/dist/core/hooks/pre-review.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Pre-Review Hook
+ *
+ * Quality gate checks before entering Review phase:
+ * 1. All tasks in tasks.md are completed
+ * 2. Progress data is consistent with tasks.md
+ * 3. Specs completeness check (all delta specs have content)
+ */
+interface CheckResult {
+    passed: boolean;
+    message: string;
+    details?: string[];
+}
+export interface PreReviewResult {
+    passed: boolean;
+    details: {
+        tasksComplete: CheckResult;
+        progressConsistent: CheckResult;
+        specsComplete: CheckResult;
+    };
+}
+/**
+ * Run all pre-review checks for a change directory.
+ */
+export declare function preReviewHook(changePath: string): Promise<PreReviewResult>;
+export {};
+//# sourceMappingURL=pre-review.d.ts.map

package/dist/core/hooks/pre-review.js

@@ -0,0 +1,169 @@
+/**
+ * Pre-Review Hook
+ *
+ * Quality gate checks before entering Review phase:
+ * 1. All tasks in tasks.md are completed
+ * 2. Progress data is consistent with tasks.md
+ * 3. Specs completeness check (all delta specs have content)
+ */
+import path from 'path';
+import { FileSystemUtils } from '../../utils/file-system.js';
+import { readdirSync, existsSync } from 'fs';
+/**
+ * Run all pre-review checks for a change directory.
+ */
+export async function preReviewHook(changePath) {
+    const checks = {
+        tasksComplete: await checkTasksCompletion(changePath),
+        progressConsistent: await checkProgressConsistency(changePath),
+        specsComplete: await checkSpecsCompleteness(changePath),
+    };
+    return {
+        passed: Object.values(checks).every(c => c.passed),
+        details: checks,
+    };
+}
+/**
+ * Check that all tasks in tasks.md are completed.
+ */
+async function checkTasksCompletion(changePath) {
+    const tasksPath = path.join(changePath, 'tasks.md');
+    if (!await FileSystemUtils.fileExists(tasksPath)) {
+        return {
+            passed: false,
+            message: 'tasks.md not found',
+        };
+    }
+    try {
+        const content = await FileSystemUtils.readFile(tasksPath);
+        const allTasks = content.match(/^- \[[ x]\] .+$/gm) || [];
+        const uncompletedTasks = content.match(/^- \[ \] .+$/gm) || [];
+        const completedTasks = content.match(/^- \[x\] .+$/gm) || [];
+        if (allTasks.length === 0) {
+            return {
+                passed: false,
+                message: 'No tasks found in tasks.md',
+            };
+        }
+        if (uncompletedTasks.length > 0) {
+            return {
+                passed: false,
+                message: `${uncompletedTasks.length}/${allTasks.length} tasks uncompleted`,
+                details: uncompletedTasks.map(t => t.trim()),
+            };
+        }
+        return {
+            passed: true,
+            message: `All ${completedTasks.length} tasks completed`,
+        };
+    }
+    catch {
+        return {
+            passed: false,
+            message: 'Failed to read tasks.md',
+        };
+    }
+}
+/**
+ * Check that progress.json data is consistent with tasks.md counts.
+ */
+async function checkProgressConsistency(changePath) {
+    const progressPath = path.join(changePath, 'metrics', 'progress.json');
+    const tasksPath = path.join(changePath, 'tasks.md');
+    if (!await FileSystemUtils.fileExists(progressPath)) {
+        return {
+            passed: true,
+            message: 'No progress.json found (skipped)',
+        };
+    }
+    if (!await FileSystemUtils.fileExists(tasksPath)) {
+        return {
+            passed: true,
+            message: 'No tasks.md found (skipped)',
+        };
+    }
+    try {
+        const progressContent = await FileSystemUtils.readFile(progressPath);
+        const progress = JSON.parse(progressContent);
+        const tasksContent = await FileSystemUtils.readFile(tasksPath);
+        const totalFromTasks = (tasksContent.match(/^- \[[ x]\] .+$/gm) || []).length;
+        const completedFromTasks = (tasksContent.match(/^- \[x\] .+$/gm) || []).length;
+        const totalFromProgress = progress.totalTasks || 0;
+        if (totalFromProgress !== totalFromTasks) {
+            return {
+                passed: false,
+                message: `Task count mismatch: progress.json says ${totalFromProgress}, tasks.md has ${totalFromTasks}`,
+                details: [
+                    `progress.json totalTasks: ${totalFromProgress}`,
+                    `tasks.md total tasks: ${totalFromTasks}`,
+                    `tasks.md completed: ${completedFromTasks}`,
+                ],
+            };
+        }
+        return {
+            passed: true,
+            message: `Progress consistent: ${completedFromTasks}/${totalFromTasks} tasks`,
+        };
+    }
+    catch {
+        return {
+            passed: true,
+            message: 'Progress consistency check skipped (parse error)',
+        };
+    }
+}
+/**
+ * Check that all delta spec files under specs/ have meaningful content.
+ */
+async function checkSpecsCompleteness(changePath) {
+    const specsDir = path.join(changePath, 'specs');
+    if (!existsSync(specsDir)) {
+        return {
+            passed: false,
+            message: 'specs/ directory not found',
+        };
+    }
+    try {
+        const capabilities = readdirSync(specsDir, { withFileTypes: true })
+            .filter(e => e.isDirectory())
+            .map(e => e.name);
+        if (capabilities.length === 0) {
+            return {
+                passed: false,
+                message: 'No capability directories found in specs/',
+            };
+        }
+        const emptySpecs = [];
+        for (const cap of capabilities) {
+            const specPath = path.join(specsDir, cap, 'spec.md');
+            if (!existsSync(specPath)) {
+                emptySpecs.push(`${cap}/spec.md (missing)`);
+                continue;
+            }
+            const content = await FileSystemUtils.readFile(specPath);
+            // Check if spec has at least one delta marker (ADDED/MODIFIED/REMOVED)
+            const hasDelta = /\b(ADDED|MODIFIED|REMOVED)\b/.test(content);
+            if (!hasDelta) {
+                emptySpecs.push(`${cap}/spec.md (no delta markers)`);
+            }
+        }
+        if (emptySpecs.length > 0) {
+            return {
+                passed: false,
+                message: `${emptySpecs.length} spec(s) incomplete`,
+                details: emptySpecs,
+            };
+        }
+        return {
+            passed: true,
+            message: `All ${capabilities.length} spec(s) complete`,
+        };
+    }
+    catch {
+        return {
+            passed: false,
+            message: 'Failed to check specs completeness',
+        };
+    }
+}
+//# sourceMappingURL=pre-review.js.map

package/dist/core/hooks/record-progress.d.ts

@@ -98,6 +98,8 @@ interface SkillCallRecord {
     durationMs?: number;
     success: boolean;
     outputSummary?: string;
+    afterAction?: string;
+    flowResumed?: boolean;
 }
 /**
  * Hook 触发记录
@@ -149,6 +151,28 @@ export interface PhaseDurationRecord {
     taskCount: number;
     completedTaskCount: number;
 }
+/**
+ * Proposal change record for tracking modifications to proposal files
+ */
+export interface ProposalChangeRecord {
+    changeRecordId: string;
+    timestamp: string;
+    phase: string;
+    triggeredBy: 'reverse-sync' | 'manual-edit' | 'ai-supplement' | 'review-fix';
+    modifiedFiles: Array<{
+        filePath: string;
+        changeType: 'modified' | 'created' | 'deleted';
+        summary: string;
+        diff?: {
+            before: string;
+            after: string;
+        };
+        linesAdded?: number;
+        linesRemoved?: number;
+    }>;
+    reason?: string;
+    relatedDeviationId?: string;
+}
 export interface ProgressData {
     changeId: string;
     sessionId: string;
@@ -181,6 +205,7 @@ export interface ProgressData {
             archive: number;
         };
     };
+    proposalChanges: ProposalChangeRecord[];
     events?: Array<{
         event: string;
         timestamp: string;