@zhuan-ai/zhuanspec 2.15.7 → 2.16.2

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

@@ -3,6 +3,7 @@ import { FileSystemUtils } from '../../utils/file-system.js';
 import { readdirSync, rmSync } from 'fs';
 import chalk from 'chalk';
 import { getBeijingTime, getBeijingTimeForFilename } from './record-progress.js';
+import { scanKnowledgeEntries, rebuildIndexContent, } from './knowledge-index.js';
 export async function postArchiveHook(options) {
     const output = await runPostArchiveHook(options.archived || '');
     if (options.json) {
@@ -19,21 +20,11 @@ async function runPostArchiveHook(archivedChange) {
     const repoRoot = process.cwd();
     const zhuanspecDir = path.join(repoRoot, 'zhuanspec');
     const knowledgeDir = path.join(zhuanspecDir, 'knowledge');
-    // 1. Update archive log
-    console.log(chalk.gray('  → 更新知识索引...'));
-    await FileSystemUtils.createDirectory(knowledgeDir);
     const indexPath = path.join(knowledgeDir, 'index.md');
-    const line = `- ${getBeijingTime()} archived: ${archivedChange}`;
-    if (await FileSystemUtils.fileExists(indexPath)) {
-        const existing = await FileSystemUtils.readFile(indexPath);
-        await FileSystemUtils.writeFile(indexPath, `${existing.trimEnd()}\n${line}\n`);
-    }
-    else {
-        await FileSystemUtils.writeFile(indexPath, `# Knowledge Index\n\n## Archive Log\n${line}\n`);
-    }
-    // 2. Collect change knowledge (extract best practices, implicit conventions)
+    // 1. Collect change knowledge (extract best practices, implicit conventions)
     // 注意：知识库只保留三类目录 troubleshooting / best-practices / implicit-conventions，
     // 原“决策类”内容合并进 best-practices；踩坑类走 zhuanspec:knowledge skill 单独沉淀。
+    await FileSystemUtils.createDirectory(knowledgeDir);
     console.log(chalk.gray('  → 提取设计文档中的知识记录...'));
     const knowledgeResult = await collectChangeKnowledge(zhuanspecDir, archivedChange, knowledgeDir);
     if (knowledgeResult.bestPractices > 0) {
@@ -42,7 +33,28 @@ async function runPostArchiveHook(archivedChange) {
     if (knowledgeResult.implicitConventions > 0) {
         console.log(chalk.gray(`    - 隐式约定：${knowledgeResult.implicitConventions} 条`));
     }
-    // 3. Cleanup temp files
+    // 2. Reindex 三分区（修复：archive 前的 refreshBusinessTemplateFromRemote 会用远端 index.md
+    //    覆盖本地，导致 review/knowledge skill 期间 appendIndexEntry 的登记行丢失。
+    //    这里基于本地 troubleshooting/ best-practices/ implicit-conventions/ 实际文件重建三分区，
+    //    保留远端拉来的 ## Archive Log 既有内容。）
+    console.log(chalk.gray('  → 重建知识索引（三分区 + Archive Log）...'));
+    const scan = await scanKnowledgeEntries(knowledgeDir);
+    const existingIndex = (await FileSystemUtils.fileExists(indexPath))
+        ? await FileSystemUtils.readFile(indexPath)
+        : null;
+    const rebuilt = rebuildIndexContent(scan, existingIndex);
+    await FileSystemUtils.writeFile(indexPath, rebuilt);
+    console.log(chalk.gray(`    - troubleshooting=${scan.entries.filter((e) => e.category === 'troubleshooting').length}, ` +
+        `best-practices=${scan.entries.filter((e) => e.category === 'best-practices').length}, ` +
+        `implicit-conventions=${scan.entries.filter((e) => e.category === 'implicit-conventions').length}`));
+    if (scan.warnings.length > 0) {
+        console.log(chalk.yellow(`    ⚠ Front Matter 不完整 ${scan.warnings.length} 条，建议补齐关键词/适用场景`));
+    }
+    // 3. Append 本次 archive log 行
+    const archiveLogLine = `- ${getBeijingTime()} archived: ${archivedChange}`;
+    const afterReindex = await FileSystemUtils.readFile(indexPath);
+    await FileSystemUtils.writeFile(indexPath, `${afterReindex.trimEnd()}\n${archiveLogLine}\n`);
+    // 4. Cleanup temp files
     console.log(chalk.gray('  → 清理临时文件...'));
     const tempFilesCleaned = await cleanupTempFiles(zhuanspecDir);
     if (tempFilesCleaned > 0) {

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

@@ -7,6 +7,7 @@
  * 3. Track tool calls for metrics
  */
 import { Phase } from '../../utils/phase-utils.js';
+import type { PhaseAccuracyEntry, TrackedKind } from '../metrics/code-accuracy.js';
 /**
  * Atomic write JSON file: write to temp file first, then rename
  * This prevents half-written files during crashes or concurrent writes
@@ -147,6 +148,7 @@ export interface PhaseDurationRecord {
     phase: Phase;
     startedAt: string;
     endedAt?: string;
+    lastUpdatedAt?: string;
     durationMs: number;
     taskCount: number;
     completedTaskCount: number;
@@ -174,7 +176,11 @@ export interface ProposalChangeRecord {
     relatedDeviationId?: string;
 }
 /**
- * 用户纠偏事件记录（由 deviation-check 写入 .correction-log）
+ * 用户纠偏事件记录
+ *
+ * v2.15.16 Sprint 3 起：.correction-log 已下线，纠偏事件由 user-input-hook
+ * 写入 user_inputs.json 的 correctionSignal / postBaseline / resolution 字段统一管理。
+ * 此类型仅保留给 progress.ts resolve-correction 命令的老 change 兼容路径使用。
  */
 export interface CorrectionRecord {
     ts: string;
@@ -197,8 +203,18 @@ export interface AccuracyData {
         originalRate: number;
         overriddenRate: number;
         reason?: string;
+        /** 纠正前的 raw 快照（完整保留，供事后差异分析；历史数据可能缺失） */
+        originalRateRaw?: number;
+        originalAiTotalLines?: number;
+        originalUserCorrectionLines?: number;
     }>;
     correctionEdits?: CorrectionEditRecord[];
+    /**
+     * 分阶段准确率桶（Task 3）。
+     * 顶层 aiLinesAdded / userCorrectionLines / aiTotalLines = 各 phase 桶求和（全生命周期聚合）。
+     * 纠偏明细不放在桶内；按 phase 查明细：correctionEdits.filter(e => e.phase === X)。
+     */
+    phaseAccuracy?: PhaseAccuracyEntry[];
 }
 export interface CorrectionEditRecord {
     filePath: string;
@@ -207,6 +223,17 @@ export interface CorrectionEditRecord {
     strategy: 'L1' | 'L2' | 'L3' | 'correction-context';
     agentType?: string;
     timestamp: string;
+    /** 该 edit 发生在哪个 phase（供按 phase 查明细时过滤用） */
+    phase?: string;
+    /** 本 edit 所属的文件白名单类别 */
+    trackedKind?: TrackedKind;
+    /** 纠偏触发源头信息（Task 6），用于 prompt ↔ edit 联关查询 */
+    triggeredBy?: {
+        source: 'correction-keyword' | 'post-baseline-prompt' | 'pending-correction-marker';
+        promptId?: string;
+        promptIndex?: number;
+        promptSnippet?: string;
+    };
 }
 /**
  * 纠偏上下文标记 — 替代 accuracy snapshot 的精准归因机制。
@@ -227,6 +254,41 @@ export interface CorrectionContext {
     path: 'A' | 'B' | 'C' | 'D';
     expiresAt: string;
     phase: string;
+    /**
+     * 纠偏触发来源：
+     *   - 'correction-keyword'        用户 prompt 命中纠偏关键词 → deviation-check → resolve-correction CLI
+     *   - 'pending-correction-marker' .pending-correction 文件兑底（并行竞态兼容）
+     *   - 'post-baseline-prompt'      phaseBaselines 打标后的 UserPromptSubmit（Task 0）
+     */
+    source?: 'correction-keyword' | 'post-baseline-prompt' | 'pending-correction-marker';
+    /** 当前 phase 内的 user prompt 序号（1-based），仅 source='post-baseline-prompt' 有意义 */
+    promptIndex?: number;
+    /** 关联的 user_inputs.json.inputId，用于查明细（Task 6） */
+    promptId?: string;
+    /** prompt 文本前 120 字符摘要，冗余存一份避免频繁 join user_inputs.json */
+    promptSnippet?: string;
+}
+/**
+ * Phase baseline 打标（Task 0）——“首版完成标识”。
+ *
+ * 语义：某 phase 的 markedAt 写入后，该 phase 首版已完成，
+ * 之后的 user prompt 触发修改才算纠偏。
+ *
+ * 打标路径（三路径 OR，先到先得，幂等）：
+ *   - auto-file-complete：Stop hook 中核心产出文件齐备
+ *   - auto-stop：phase 切换时兜底打标（既然都切下一 phase 了，上一 phase 视为“首版完成”）
+ *   - manual-cli：`zhuanspec progress mark-baseline` 手动打标
+ */
+export interface PhaseBaselineEntry {
+    markedAt: string;
+    markedBy: 'auto-file-complete' | 'auto-stop' | 'manual-cli';
+    firstStopAt?: string;
+}
+export interface PhaseBaselines {
+    techDesign?: PhaseBaselineEntry;
+    propose?: PhaseBaselineEntry;
+    apply?: PhaseBaselineEntry;
+    review?: PhaseBaselineEntry;
 }
 export interface ProgressData {
     changeId: string;
@@ -271,6 +333,7 @@ export interface ProgressData {
     lastEvent?: string;
     accuracy?: AccuracyData;
     correctionContext?: CorrectionContext;
+    phaseBaselines?: PhaseBaselines;
 }
 export declare function recordProgressHook(options: RecordProgressOptions): Promise<void>;
 /**

package/dist/core/hooks/record-progress.js

@@ -11,7 +11,7 @@ import { promises as fsPromises, existsSync, readFileSync, unlinkSync } from 'fs
 import { FileSystemUtils } from '../../utils/file-system.js';
 import { PHASE_ORDER } from '../../utils/phase-utils.js';
 import { resolveZhuanSpecRoot } from '../../utils/resolve-root.js';
-import { isCodeFile } from '../metrics/code-accuracy.js';
+import { isCodeFile, isTrackedFileForPhase, getOrCreatePhaseBucket, recomputeAccuracyRate, persistAccuracyJson, appendAccuracyDebugLog } from '../metrics/code-accuracy.js';
 import { detectHookHost, sanitizeCodexEnvelope } from '../../utils/hook-host.js';
 const fs = fsPromises;
 /**
@@ -112,6 +112,7 @@ export async function recoverProgressJsonForWrite(filePath) {
                 phaseDurations: [{
                         phase: recoveredPhase,
                         startedAt: '',
+                        lastUpdatedAt: '',
                         durationMs: 0,
                         taskCount: 0,
                         completedTaskCount: 0,
@@ -502,6 +503,37 @@ async function runRecordProgress(filePath, toolName, success, stdinData) {
             timestamp: getBeijingTime(),
             triggeredBy: currentTask || 'manual',
         });
+        // === Task 0 路径 2：phase 切换时给上一 phase 补 baseline（兜底打标）===
+        // previousPhase ∈ {techDesign, propose, apply, review} 才打标；idle/archive 排除
+        const BASELINE_PHASES = ['techDesign', 'propose', 'apply', 'review'];
+        if (BASELINE_PHASES.includes(previousPhase)) {
+            progress.phaseBaselines = progress.phaseBaselines || {};
+            const key = previousPhase;
+            const existedBefore = !!progress.phaseBaselines[key]?.markedAt;
+            if (!existedBefore) {
+                progress.phaseBaselines[key] = {
+                    markedAt: getBeijingTime(),
+                    markedBy: 'auto-stop',
+                };
+            }
+            // 埋点：baseline.mark
+            appendAccuracyDebugLog(changeDir, {
+                type: 'baseline.mark',
+                phase: key,
+                trigger: 'auto-stop',
+                changeId,
+                input: { toPhase: phase, previousPhase: key },
+                output: { markedBy: 'auto-stop', existed: existedBefore },
+            });
+        }
+        // === 跨 phase 清理 correctionContext：
+        // 旧 phase 的 active 不应泄漏到新 phase，新 phase 是否进入纠偏态
+        // 由新 phase 的 phaseBaselines + UserPromptSubmit 重新判定
+        if (progress.correctionContext
+            && progress.correctionContext.active
+            && progress.correctionContext.phase !== phase) {
+            progress.correctionContext.active = false;
+        }
     }
     progress.currentNode = process.env.ZHUANSPEC_CURRENT_NODE || phase;
     progress.currentTask = currentTask || progress.currentTask;
@@ -610,7 +642,20 @@ async function runRecordProgress(filePath, toolName, success, stdinData) {
         contentSource = toolInputEdits.length > 0 ? 'edits[]' : 'none';
     }
     let estimatedLines = 0;
-    const inCorrectionContext = !!(progress.correctionContext?.active) || pendingExists;
+    // === P0 兜底：post-baseline-fallback ===
+    // 正常链路：UserPromptSubmit 的 user-input hook 会在 phaseBaseline 已打标时写入
+    // correctionContext.active=true。但若 .claude/settings.json 未挂 user-input hook
+    // （老版本模板），correctionContext 会保持 null，导致后续 Write 误入 linesAdded。
+    // 本兜底：只要当前 phase 的 phaseBaseline 已打标，就视同进入纠正上下文。
+    // 语义：Stop 打 baseline 代表该 phase 首版齐备，之后的同 phase Write 绝大多数
+    // 由后续 user prompt 驱动（AI 不会主动在无 prompt 情况下继续大改），归为 user 纠正。
+    const _phaseKeyForBaseline = progress.phase;
+    const _baselinePhases = ['techDesign', 'propose', 'apply', 'review'];
+    const baselineMarkedForPhase = _baselinePhases.includes(_phaseKeyForBaseline)
+        && !!progress.phaseBaselines?.[_phaseKeyForBaseline]?.markedAt;
+    const ccActiveRaw = !!(progress.correctionContext?.active);
+    const inCorrectionContext = ccActiveRaw || pendingExists || baselineMarkedForPhase;
+    const correctionFallbackReason = (!ccActiveRaw && !pendingExists && baselineMarkedForPhase) ? 'post-baseline-fallback' : 'none';
     // === 调试日志：在 changeDir 下写 .correction-debug.log，方便排查“为什么没记录上” ===
     const correctionDebugLog = (branch, addedTo, delta) => {
         try {
@@ -628,6 +673,8 @@ async function runRecordProgress(filePath, toolName, success, stdinData) {
                 contentSource,
                 changeLines,
                 pendingExists,
+                baselineMarkedForPhase,
+                fallbackReason: correctionFallbackReason,
                 correctionContext: progress.correctionContext
                     ? { active: ccActive, path: ccPath, expiresAt: ccExpiresAt, phase: ccPhase, currentPhase: progress.phase }
                     : null,
@@ -646,46 +693,175 @@ async function runRecordProgress(filePath, toolName, success, stdinData) {
             // 日志失败不阻断主流程
         }
     };
-    if (changeLines > 0 && filePath && isCodeFile(filePath)) {
-        estimatedLines = changeLines;
-        if (inCorrectionContext) {
-            // 纠偏上下文：行数计入 userCorrectionLines，不进 linesAdded
+    if (changeLines > 0 && filePath) {
+        // Task 3.3：按 phase 选白名单（techDesign/propose/apply/review），而非笼统用 isCodeFile
+        const track = isTrackedFileForPhase(filePath, progress.phase, changeDir);
+        if (!track.tracked) {
+            correctionDebugLog(`skipped/out-of-phase-whitelist`, 'skipped', 0);
+            appendAccuracyDebugLog(changeDir, {
+                type: 'skip.out-of-phase-whitelist',
+                phase: progress.phase,
+                trigger: 'hook',
+                changeId,
+                skipReason: 'out-of-phase-whitelist',
+                input: { tool: toolName, file: filePath, changeLines },
+            });
+        }
+        else {
+            estimatedLines = changeLines;
+            const trackedKind = track.kind;
+            const trackedPhase = progress.phase;
+            // 确保 accuracy 结构存在
             if (!progress.accuracy) {
                 progress.accuracy = {
                     aiLinesAdded: 0, aiLinesModified: 0, aiTotalLines: 0,
                     userCorrectionLines: 0, accuracyRate: 1.0,
-                    correctionEdits: [],
+                    correctionEdits: [], phaseAccuracy: [],
                 };
             }
-            progress.accuracy.userCorrectionLines = (progress.accuracy.userCorrectionLines || 0) + changeLines;
-            progress.accuracy.correctionEdits = progress.accuracy.correctionEdits || [];
-            progress.accuracy.correctionEdits.push({
-                filePath,
-                editLines: changeLines,
-                source: 'user',
-                strategy: 'correction-context',
-                agentType: progress.correctionContext?.path,
-                timestamp,
-            });
-            correctionDebugLog(`${toolName}/correction`, 'userCorrectionLines', changeLines);
-        }
-        else {
-            // 正常 AI 产出
-            progress.linesAdded += changeLines;
-            correctionDebugLog(`${toolName}/normal`, 'linesAdded', changeLines);
+            const bucket = getOrCreatePhaseBucket(progress, trackedPhase, trackedKind);
+            if (inCorrectionContext) {
+                // 工具白名单守卫：techDesign / propose 阶段的纠偏统计只接受增量编辑（Edit/MultiEdit），
+                // 禁止 Write。原因：tech-spec.md / proposal.md 通常是整文件 Write 产出，一旦被误判为纠偏，
+                // 会把整份文件行数当成 userCorrectionLines 记入，导致分子被严重放大、accuracyRate 失真。
+                // apply / review 阶段不受此限制（apply 可 Write 新增代码文件，review-report.md 也常由 Write 生成）。
+                if ((trackedPhase === 'techDesign' || trackedPhase === 'propose') && toolName === 'Write') {
+                    correctionDebugLog(`skipped/write-blocked-${trackedPhase}-correction`, 'skipped', 0);
+                    appendAccuracyDebugLog(changeDir, {
+                        type: `skip.write-blocked-${trackedPhase}-correction`,
+                        phase: trackedPhase,
+                        kind: trackedKind,
+                        trigger: 'hook',
+                        changeId,
+                        skipReason: `write-blocked-${trackedPhase}-correction`,
+                        input: { tool: toolName, file: filePath, changeLines },
+                    });
+                }
+                else {
+                    // 纠偏上下文：桶 + 顶层 userCorrectionLines 同步累加
+                    bucket.userCorrectionLines += changeLines;
+                    bucket.lastUpdatedAt = timestamp;
+                    progress.accuracy.userCorrectionLines = (progress.accuracy.userCorrectionLines || 0) + changeLines;
+                    progress.accuracy.correctionEdits = progress.accuracy.correctionEdits || [];
+                    // 提取纠偏触发源头信息（Task 6）
+                    // post-baseline-fallback 兜底命中时，语义等价于 user-input hook 写入的 'post-baseline-prompt'。
+                    const ccSource = progress.correctionContext?.source
+                        || (pendingExists
+                            ? 'pending-correction-marker'
+                            : (correctionFallbackReason === 'post-baseline-fallback'
+                                ? 'post-baseline-prompt'
+                                : 'correction-keyword'));
+                    // Task 6：若 correctionContext 无 prompt 元数据（典型于 pending-correction-marker 兑底路径），
+                    // 从 .pending-correction marker JSON 中回填 promptId / phaseInputIndex / promptSnippet。
+                    let fallbackPromptId;
+                    let fallbackPromptIndex;
+                    let fallbackPromptSnippet;
+                    if (!progress.correctionContext?.promptId && pendingExists) {
+                        try {
+                            const markerRaw = readFileSync(pendingMarkerPath, 'utf-8');
+                            if (markerRaw) {
+                                const markerData = JSON.parse(markerRaw);
+                                fallbackPromptId = markerData.promptId;
+                                fallbackPromptIndex = markerData.phaseInputIndex;
+                                fallbackPromptSnippet = markerData.promptSnippet;
+                            }
+                        }
+                        catch {
+                            // marker 解析失败不阻断主流程
+                        }
+                    }
+                    const promptId = progress.correctionContext?.promptId ?? fallbackPromptId;
+                    const promptIndex = progress.correctionContext?.promptIndex ?? fallbackPromptIndex;
+                    const promptSnippet = progress.correctionContext?.promptSnippet ?? fallbackPromptSnippet;
+                    progress.accuracy.correctionEdits.push({
+                        filePath,
+                        editLines: changeLines,
+                        source: 'user',
+                        strategy: 'correction-context',
+                        agentType: progress.correctionContext?.path,
+                        timestamp,
+                        phase: trackedPhase,
+                        trackedKind,
+                        triggeredBy: {
+                            source: ccSource,
+                            promptId,
+                            promptIndex,
+                            promptSnippet,
+                        },
+                    });
+                    // 记录 phase 维度 promptId（去重）
+                    if (promptId && !bucket.correctionPromptIds.includes(promptId)) {
+                        bucket.correctionPromptIds.push(promptId);
+                    }
+                    correctionDebugLog(`${toolName}/correction`, 'userCorrectionLines', changeLines);
+                    appendAccuracyDebugLog(changeDir, {
+                        type: 'correction.record',
+                        phase: trackedPhase,
+                        kind: trackedKind,
+                        trigger: 'hook',
+                        changeId,
+                        input: {
+                            tool: toolName,
+                            file: filePath,
+                            changeLines,
+                            contentSource,
+                            ccSource,
+                            promptId,
+                            promptIndex,
+                        },
+                        output: {
+                            bucketCorrection: bucket.userCorrectionLines,
+                            topCorrection: progress.accuracy.userCorrectionLines,
+                            promptIdsCount: bucket.correctionPromptIds.length,
+                        },
+                    });
+                }
+            }
+            else {
+                // 正常 AI 产出：桶 + 顶层 aiLinesAdded/aiTotalLines 同步累加，同时顶层 progress.linesAdded 仍需累加以兼容旧逻辑
+                bucket.aiLinesAdded += changeLines;
+                bucket.aiTotalLines += changeLines;
+                bucket.lastUpdatedAt = timestamp;
+                progress.accuracy.aiLinesAdded = (progress.accuracy.aiLinesAdded || 0) + changeLines;
+                progress.accuracy.aiTotalLines = (progress.accuracy.aiTotalLines || 0) + changeLines;
+                progress.linesAdded += changeLines;
+                correctionDebugLog(`${toolName}/normal`, 'linesAdded', changeLines);
+                appendAccuracyDebugLog(changeDir, {
+                    type: 'ai.record',
+                    phase: trackedPhase,
+                    kind: trackedKind,
+                    trigger: 'hook',
+                    changeId,
+                    input: { tool: toolName, file: filePath, changeLines, contentSource },
+                    output: {
+                        bucketAiTotal: bucket.aiTotalLines,
+                        topAiTotal: progress.accuracy.aiTotalLines,
+                    },
+                });
+            }
+            // 累加后重算 accuracyRate（顶层 + 各桶）
+            recomputeAccuracyRate(progress, { changeDir, trigger: 'hook' });
+            // 统一同步 accuracy.json
+            await persistAccuracyJson(changeDir, progress);
         }
     }
     else {
-        // 未进入计量分支：记录原因（非代码文件 / 字段缺失 / 非写入工具）
+        // 未进入计量分支：记录原因（字段缺失 / 非写入工具）
         if (toolName === 'Write' || toolName === 'Edit' || toolName === 'MultiEdit') {
             const reason = !filePath
                 ? 'no-file-path'
-                : !isCodeFile(filePath)
-                    ? 'non-code-file'
-                    : changeLines === 0
-                        ? `empty-${contentSource}`
-                        : 'unknown';
+                : changeLines === 0
+                    ? `empty-${contentSource}`
+                    : 'unknown';
             correctionDebugLog(`skipped/${reason}`, 'skipped', 0);
+            appendAccuracyDebugLog(changeDir, {
+                type: `skip.${reason}`,
+                phase: progress.phase,
+                trigger: 'hook',
+                changeId,
+                skipReason: reason,
+                input: { tool: toolName, file: filePath || null, changeLines, contentSource },
+            });
         }
     }
     const tokenUsageFromEnv = Number(process.env.ZHUANSPEC_TOKEN_USAGE || 0);
@@ -730,6 +906,15 @@ async function runRecordProgress(filePath, toolName, success, stdinData) {
                 progress.stats.durationMs.review = elapsedMs;
             if (phase === 'archive')
                 progress.stats.durationMs.archive = elapsedMs;
+            // v2.15.16：同步刷新活跃段的 phaseDurations 记录，进行中也能从单条直接读出
+            // 实时 durationMs / lastUpdatedAt。endedAt 仍仅在 phase 切换时填。
+            const activeEntry = [...progress.phaseDurations]
+                .reverse()
+                .find(pd => pd.phase === phase && !pd.endedAt);
+            if (activeEntry) {
+                activeEntry.durationMs = elapsedMs;
+                activeEntry.lastUpdatedAt = getBeijingTime();
+            }
         }
     }
     // === Auto-count tasks from tasks.md ===
@@ -756,31 +941,10 @@ async function runRecordProgress(filePath, toolName, success, stdinData) {
             // Ignore tasks.md read errors
         }
     }
-    // === 合并 .correction-log 到 progress.corrections（供 Stop hook 沉淀询问使用）===
-    try {
-        const correctionLogPath = path.join(changeDir, '.correction-log');
-        if (existsSync(correctionLogPath)) {
-            const content = readFileSync(correctionLogPath, 'utf-8');
-            const parsed = [];
-            for (const line of content.split('\n')) {
-                const trimmed = line.trim();
-                if (!trimmed)
-                    continue;
-                try {
-                    parsed.push(JSON.parse(trimmed));
-                }
-                catch {
-                    // skip malformed line
-                }
-            }
-            if (parsed.length > 0) {
-                progress.corrections = parsed;
-            }
-        }
-    }
-    catch {
-        // ignore correction log read errors
-    }
+    // v2.15.16 Sprint 3：.correction-log → progress.corrections 的合并逻辑已下线。
+    // 纠偏明细现由 user-input-hook 写入 user_inputs.json（correctionSignal / postBaseline /
+    // resolution 字段），review 步骤 0 与 knowledge skill 模式 B 均直接读 user_inputs.json，
+    // 不再依赖 progress.corrections。
     // Write progress file atomically
     await atomicWriteJson(progressPath, progress);
     // Also update tool_calls.json separately for detailed tracking
@@ -933,6 +1097,7 @@ function createNewProgress(changeId) {
         phaseDurations: [{
                 phase: initialPhase,
                 startedAt: getBeijingTime(),
+                lastUpdatedAt: getBeijingTime(),
                 durationMs: 0,
                 taskCount: 0,
                 completedTaskCount: 0,
@@ -1006,6 +1171,7 @@ export async function initializeProgress(changeId, initialPhase = 'propose') {
                 const prevPhaseDuration = progress.phaseDurations.find(pd => pd.phase === previousPhase && !pd.endedAt);
                 if (prevPhaseDuration) {
                     prevPhaseDuration.endedAt = timestamp;
+                    prevPhaseDuration.lastUpdatedAt = timestamp;
                     const startTime = new Date(prevPhaseDuration.startedAt.replace(' ', 'T')).getTime();
                     const endTime = new Date(timestamp.replace(' ', 'T')).getTime();
                     const ms = Number.isFinite(startTime) && endTime > startTime ? endTime - startTime : 0;
@@ -1027,6 +1193,7 @@ export async function initializeProgress(changeId, initialPhase = 'propose') {
                             phase: previousPhase,
                             startedAt: inferredStart,
                             endedAt: timestamp,
+                            lastUpdatedAt: timestamp,
                             durationMs: ms,
                             taskCount: 0,
                             completedTaskCount: 0,
@@ -1040,6 +1207,7 @@ export async function initializeProgress(changeId, initialPhase = 'propose') {
                 progress.phaseDurations.push({
                     phase: initialPhase,
                     startedAt: timestamp,
+                    lastUpdatedAt: timestamp,
                     durationMs: 0,
                     taskCount: 0,
                     completedTaskCount: 0,
@@ -1117,6 +1285,7 @@ function seedInitialPhase(progress, initialPhase, timestamp) {
         for (const entry of progress.phaseDurations) {
             if (!entry.endedAt && entry.phase !== initialPhase) {
                 entry.endedAt = timestamp;
+                entry.lastUpdatedAt = timestamp;
                 const startTime = new Date((entry.startedAt || timestamp).replace(' ', 'T')).getTime();
                 const endTime = new Date(timestamp.replace(' ', 'T')).getTime();
                 entry.durationMs = Number.isFinite(startTime) && endTime > startTime ? endTime - startTime : 0;
@@ -1125,6 +1294,7 @@ function seedInitialPhase(progress, initialPhase, timestamp) {
         progress.phaseDurations.push({
             phase: initialPhase,
             startedAt: timestamp,
+            lastUpdatedAt: timestamp,
             durationMs: 0,
             taskCount: 0,
             completedTaskCount: 0,