speccore 6.69.0 → 6.71.3

package/dist/core/change-detection.d.ts

@@ -0,0 +1,121 @@
+/**
+ * change-detection — 变更感知模块（v6.69.0+）
+ *
+ * 通过 Git diff 识别变更范围，将变更文件映射到受影响的端，
+ * 支持 Pipeline 的增量分析（仅分析受影响端）。
+ *
+ * v6.69.1 修复：
+ * - 对比基准从 HEAD 改为 CONSTITUTION.md 配置的默认分支
+ * - 新增分析快照持久化，支持基于上次分析点的增量 diff
+ */
+export interface PlatformChangeInfo {
+    platform: string;
+    changedFiles: string[];
+    changeCount: number;
+}
+/**
+ * 获取 CONSTITUTION.md 配置的默认分支（带缓存）
+ * 优先级：CONSTITUTION.md > 硬编码 'main'
+ */
+export declare function getDefaultBaseRef(): string;
+/**
+ * 获取 Git 工作区的变更文件列表
+ * @param baseRef 对比的基准 ref（默认使用 CONSTITUTION.md 配置的默认分支）
+ * @returns 相对路径列表
+ */
+export declare function getChangedFiles(baseRef?: string): string[];
+/**
+ * 获取两个 commit/ref 之间的变更文件列表
+ * @param fromRef 起始 ref（如上次分析的 commit）
+ * @param toRef 结束 ref（默认 HEAD）
+ */
+export declare function getChangedFilesBetween(fromRef: string, toRef?: string): string[];
+/**
+ * 获取工作区中未跟踪的新文件
+ */
+export declare function getUntrackedFiles(): string[];
+/**
+ * 读取 CONSTITUTION.md 中的源码路径 → 端映射
+ * @returns Map<源码路径, 端名>
+ */
+export declare function loadSourcePathMap(cwd: string): Promise<Map<string, string>>;
+/**
+ * 检测变更影响的端
+ *
+ * 策略：
+ * 1. 需求/规格文件变更（010-requirements/、020-specs/）→ 影响所有端
+ * 2. 源码文件变更 → 根据 CONSTITUTION.md 的源码路径映射到对应端
+ * 3. 全局配置变更（.speccore/）→ 影响所有端
+ * 4. 其他文件变更（CI、文档等）→ 不影响分析
+ *
+ * v6.69.1: 支持基于分析快照的增量检测
+ *
+ * @param cwd 工作目录
+ * @param changedFiles 可选：预计算的变更文件列表（不传则自动检测）
+ * @param options 可选配置
+ * @returns 受影响的端名列表（空数组表示无变更或无法检测）
+ */
+export declare function detectAffectedPlatforms(cwd: string, changedFiles?: string[], options?: {
+    /** 分析范围标识，用于读取快照（如 'global', 'Iteration-Q2', 'Task-001'） */
+    scope?: string;
+    /** 是否使用增量模式（基于上次分析的 commit 做 diff） */
+    incremental?: boolean;
+}): Promise<string[]>;
+/**
+ * 获取详细的变更信息（按端分组）
+ */
+export declare function getPlatformChangeDetails(cwd: string, changedFiles?: string[]): Promise<PlatformChangeInfo[]>;
+/**
+ * 检测各端的优先级顺序（关键路径优先排序）
+ *
+ * 策略：
+ * 1. 读取迭代中所有子任务的 TaskState
+ * 2. 按 platform 分组，统计各端 high/medium/low 优先级任务数量
+ * 3. 按「high 数量降序 → medium 数量降序 → low 数量降序」排序端
+ * 4. 如果某端没有任务，赋予最低优先级
+ *
+ * @param iteration 迭代名
+ * @returns 按优先级排序的端名列表（靠前的优先分析）
+ */
+export declare function detectPlatformPriorityOrder(iteration: string): Promise<string[]>;
+export interface AnalysisSnapshot {
+    lastCommit: string;
+    analyzedAt: string;
+    branch: string;
+}
+export interface AnalysisSnapshots {
+    [scope: string]: AnalysisSnapshot;
+}
+/**
+ * 读取分析快照文件
+ */
+export declare function readAnalysisSnapshots(): Promise<AnalysisSnapshots>;
+/**
+ * 写入分析快照文件
+ */
+export declare function writeAnalysisSnapshots(snapshots: AnalysisSnapshots): Promise<void>;
+/**
+ * 获取当前 HEAD 的 commit hash
+ */
+export declare function getCurrentCommitHash(): string | null;
+/**
+ * 获取当前分支名
+ */
+export declare function getCurrentBranch(): string | null;
+/**
+ * 基于上次分析的快照获取增量变更文件
+ * @param scope 分析范围标识（如 'global', 'Iteration-Q2', 'Task-001'）
+ * @returns 自上次分析以来的变更文件列表（无快照则 fallback 到默认分支对比）
+ */
+export declare function getIncrementalChangedFiles(scope: string): Promise<string[]>;
+/**
+ * 记录分析快照（分析完成后调用）
+ * @param scope 分析范围标识（如 'global', 'Iteration-Q2', 'Task-001'）
+ */
+export declare function recordAnalysisSnapshot(scope: string): Promise<void>;
+/**
+ * 清除指定范围的分析快照
+ * @param scope 分析范围标识，不传则清除全部
+ */
+export declare function clearAnalysisSnapshot(scope?: string): Promise<void>;
+//# sourceMappingURL=change-detection.d.ts.map

package/dist/core/change-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-detection.d.ts","sourceRoot":"","sources":["../../src/core/change-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAY1D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAe,GAAG,MAAM,EAAE,CAWxF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAW5C;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgDjF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE;IACR,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC,MAAM,EAAE,CAAC,CA2DnB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAoB/B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgCtF;AAMD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACnC;AAID;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAUxE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CASpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAShD;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BjF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBzE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAczE"}

package/dist/core/change-detection.js

@@ -0,0 +1,459 @@
+"use strict";
+/**
+ * change-detection — 变更感知模块（v6.69.0+）
+ *
+ * 通过 Git diff 识别变更范围，将变更文件映射到受影响的端，
+ * 支持 Pipeline 的增量分析（仅分析受影响端）。
+ *
+ * v6.69.1 修复：
+ * - 对比基准从 HEAD 改为 CONSTITUTION.md 配置的默认分支
+ * - 新增分析快照持久化，支持基于上次分析点的增量 diff
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultBaseRef = getDefaultBaseRef;
+exports.getChangedFiles = getChangedFiles;
+exports.getChangedFilesBetween = getChangedFilesBetween;
+exports.getUntrackedFiles = getUntrackedFiles;
+exports.loadSourcePathMap = loadSourcePathMap;
+exports.detectAffectedPlatforms = detectAffectedPlatforms;
+exports.getPlatformChangeDetails = getPlatformChangeDetails;
+exports.detectPlatformPriorityOrder = detectPlatformPriorityOrder;
+exports.readAnalysisSnapshots = readAnalysisSnapshots;
+exports.writeAnalysisSnapshots = writeAnalysisSnapshots;
+exports.getCurrentCommitHash = getCurrentCommitHash;
+exports.getCurrentBranch = getCurrentBranch;
+exports.getIncrementalChangedFiles = getIncrementalChangedFiles;
+exports.recordAnalysisSnapshot = recordAnalysisSnapshot;
+exports.clearAnalysisSnapshot = clearAnalysisSnapshot;
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const child_process_1 = require("child_process");
+const logger_1 = require("../utils/logger");
+// ═══════════════════════════════════════════════
+// 对比基准：默认分支读取
+// ═══════════════════════════════════════════════
+let cachedDefaultBranch = null;
+/**
+ * 获取 CONSTITUTION.md 配置的默认分支（带缓存）
+ * 优先级：CONSTITUTION.md > 硬编码 'main'
+ */
+function getDefaultBaseRef() {
+    if (cachedDefaultBranch)
+        return cachedDefaultBranch;
+    try {
+        const { loadGitConfig } = require('./git-integration');
+        const config = loadGitConfig();
+        cachedDefaultBranch = config.defaultBranch || 'main';
+    }
+    catch {
+        cachedDefaultBranch = 'main';
+    }
+    logger_1.logger.debug(`变更感知: 默认对比基准分支 = ${cachedDefaultBranch}`);
+    return cachedDefaultBranch;
+}
+/**
+ * 获取 Git 工作区的变更文件列表
+ * @param baseRef 对比的基准 ref（默认使用 CONSTITUTION.md 配置的默认分支）
+ * @returns 相对路径列表
+ */
+function getChangedFiles(baseRef) {
+    const ref = baseRef || getDefaultBaseRef();
+    try {
+        const output = (0, child_process_1.execSync)(`git diff --name-only ${ref}`, {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        if (!output)
+            return [];
+        return output.split('\n').filter(f => f.trim().length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 获取两个 commit/ref 之间的变更文件列表
+ * @param fromRef 起始 ref（如上次分析的 commit）
+ * @param toRef 结束 ref（默认 HEAD）
+ */
+function getChangedFilesBetween(fromRef, toRef = 'HEAD') {
+    try {
+        const output = (0, child_process_1.execSync)(`git diff --name-only ${fromRef}..${toRef}`, {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        if (!output)
+            return [];
+        return output.split('\n').filter(f => f.trim().length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 获取工作区中未跟踪的新文件
+ */
+function getUntrackedFiles() {
+    try {
+        const output = (0, child_process_1.execSync)('git ls-files --others --exclude-standard', {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        if (!output)
+            return [];
+        return output.split('\n').filter(f => f.trim().length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 读取 CONSTITUTION.md 中的源码路径 → 端映射
+ * @returns Map<源码路径, 端名>
+ */
+async function loadSourcePathMap(cwd) {
+    const pathMap = new Map();
+    const constitutionPath = (0, path_1.join)(cwd, '.speccore', 'CONSTITUTION.md');
+    if (!(await (0, fs_extra_1.pathExists)(constitutionPath))) {
+        return pathMap;
+    }
+    try {
+        const content = await (0, fs_extra_1.readFile)(constitutionPath, 'utf-8');
+        // 解析「项目信息」表格
+        // 格式：| 工程 | 项目名称 | 源码路径 | Git 仓库 | 默认分支 | 对应端 |
+        const lines = content.split('\n');
+        let inProjectSection = false;
+        for (const line of lines) {
+            // 检测「项目信息」章节
+            if (line.includes('## 项目信息')) {
+                inProjectSection = true;
+                continue;
+            }
+            if (inProjectSection && line.startsWith('## ')) {
+                inProjectSection = false;
+                continue;
+            }
+            if (!inProjectSection)
+                continue;
+            // 跳过表头分隔行
+            if (line.match(/^\|[-:\s|]+\|$/))
+                continue;
+            // 跳过空行和提示行
+            if (!line.includes('|') || line.includes('工程 | 项目名称'))
+                continue;
+            const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+            if (cells.length >= 6) {
+                const srcPath = cells[2]; // 源码路径列
+                const platform = cells[5]; // 对应端列
+                if (srcPath && platform && platform !== '待填写') {
+                    // 标准化路径（去掉开头的 ./）
+                    const normalized = srcPath.replace(/^\.\//, '');
+                    pathMap.set(normalized, platform);
+                }
+            }
+        }
+    }
+    catch (e) {
+        logger_1.logger.debug('读取 CONSTITUTION.md 失败:', e);
+    }
+    return pathMap;
+}
+/**
+ * 检测变更影响的端
+ *
+ * 策略：
+ * 1. 需求/规格文件变更（010-requirements/、020-specs/）→ 影响所有端
+ * 2. 源码文件变更 → 根据 CONSTITUTION.md 的源码路径映射到对应端
+ * 3. 全局配置变更（.speccore/）→ 影响所有端
+ * 4. 其他文件变更（CI、文档等）→ 不影响分析
+ *
+ * v6.69.1: 支持基于分析快照的增量检测
+ *
+ * @param cwd 工作目录
+ * @param changedFiles 可选：预计算的变更文件列表（不传则自动检测）
+ * @param options 可选配置
+ * @returns 受影响的端名列表（空数组表示无变更或无法检测）
+ */
+async function detectAffectedPlatforms(cwd, changedFiles, options) {
+    let files;
+    if (changedFiles) {
+        files = changedFiles;
+    }
+    else if (options?.incremental && options?.scope) {
+        // 增量模式：基于上次分析的 commit hash 做 diff
+        files = await getIncrementalChangedFiles(options.scope);
+        if (files.length > 0) {
+            logger_1.logger.info(`🔄 变更感知(增量): 自上次分析后新增 ${files.length} 个变更文件`);
+        }
+    }
+    else {
+        // 全量模式：与默认分支对比
+        files = [...getChangedFiles(), ...getUntrackedFiles()];
+    }
+    if (files.length === 0) {
+        logger_1.logger.debug('变更感知: 未检测到变更文件');
+        return [];
+    }
+    const pathMap = await loadSourcePathMap(cwd);
+    const affected = new Set();
+    let hasGlobalChange = false;
+    for (const file of files) {
+        // 全局变更：需求文档、规格文档、配置
+        if (file.includes('010-requirements/') ||
+            file.includes('020-specs/') ||
+            file.includes('.speccore/CONSTITUTION.md') ||
+            file.includes('.speccore/PATTERNS/')) {
+            hasGlobalChange = true;
+            break;
+        }
+        // 源码路径匹配
+        for (const [srcPath, platform] of pathMap) {
+            if (file.startsWith(srcPath + '/') || file === srcPath) {
+                affected.add(platform);
+            }
+        }
+    }
+    // 全局变更 → 返回所有端
+    if (hasGlobalChange && pathMap.size > 0) {
+        logger_1.logger.info(`🔄 变更感知: 检测到全局变更（需求/规格/配置），需分析所有 ${pathMap.size} 个端`);
+        return Array.from(new Set(pathMap.values()));
+    }
+    const result = Array.from(affected);
+    if (result.length > 0) {
+        logger_1.logger.info(`🔄 变更感知: 检测到 ${files.length} 个变更文件，影响端: ${result.join(', ')}`);
+    }
+    else {
+        logger_1.logger.debug(`变更感知: ${files.length} 个变更文件未匹配到任何端`);
+    }
+    return result;
+}
+/**
+ * 获取详细的变更信息（按端分组）
+ */
+async function getPlatformChangeDetails(cwd, changedFiles) {
+    const files = changedFiles || [...getChangedFiles(), ...getUntrackedFiles()];
+    const pathMap = await loadSourcePathMap(cwd);
+    const platformFiles = new Map();
+    for (const file of files) {
+        for (const [srcPath, platform] of pathMap) {
+            if (file.startsWith(srcPath + '/') || file === srcPath) {
+                const list = platformFiles.get(platform) || [];
+                list.push(file);
+                platformFiles.set(platform, list);
+            }
+        }
+    }
+    return Array.from(platformFiles.entries()).map(([platform, changedFiles]) => ({
+        platform,
+        changedFiles,
+        changeCount: changedFiles.length,
+    }));
+}
+// ═══════════════════════════════════════════════
+// v6.69.0+: 关键路径优先 — 端优先级检测
+// ═══════════════════════════════════════════════
+/**
+ * 检测各端的优先级顺序（关键路径优先排序）
+ *
+ * 策略：
+ * 1. 读取迭代中所有子任务的 TaskState
+ * 2. 按 platform 分组，统计各端 high/medium/low 优先级任务数量
+ * 3. 按「high 数量降序 → medium 数量降序 → low 数量降序」排序端
+ * 4. 如果某端没有任务，赋予最低优先级
+ *
+ * @param iteration 迭代名
+ * @returns 按优先级排序的端名列表（靠前的优先分析）
+ */
+async function detectPlatformPriorityOrder(iteration) {
+    const { scanTasks } = await Promise.resolve().then(() => __importStar(require('./state')));
+    const tasks = await scanTasks(iteration);
+    // 按端分组统计优先级
+    const platformStats = new Map();
+    for (const task of tasks) {
+        const platform = task.platform;
+        if (!platform)
+            continue;
+        const stats = platformStats.get(platform) || { high: 0, medium: 0, low: 0 };
+        if (task.priority === 'high')
+            stats.high++;
+        else if (task.priority === 'low')
+            stats.low++;
+        else
+            stats.medium++;
+        platformStats.set(platform, stats);
+    }
+    // 排序：high 多 → medium 多 → low 多
+    const sorted = Array.from(platformStats.entries()).sort((a, b) => {
+        const [pa, sa] = a;
+        const [pb, sb] = b;
+        if (sa.high !== sb.high)
+            return sb.high - sa.high;
+        if (sa.medium !== sb.medium)
+            return sb.medium - sa.medium;
+        return sb.low - sa.low;
+    });
+    const result = sorted.map(([platform]) => platform);
+    if (result.length > 0) {
+        logger_1.logger.info(`🎯 关键路径优先: 端优先级排序 → ${result.join(' > ')}`);
+    }
+    return result;
+}
+const SNAPSHOT_FILE = (0, path_1.join)('.speccore', 'cache', 'analysis-snapshots.json');
+/**
+ * 读取分析快照文件
+ */
+async function readAnalysisSnapshots() {
+    try {
+        if (await (0, fs_extra_1.pathExists)(SNAPSHOT_FILE)) {
+            const content = await (0, fs_extra_1.readFile)(SNAPSHOT_FILE, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch (e) {
+        logger_1.logger.debug('读取分析快照失败:', e);
+    }
+    return {};
+}
+/**
+ * 写入分析快照文件
+ */
+async function writeAnalysisSnapshots(snapshots) {
+    try {
+        await (0, fs_extra_1.writeFile)(SNAPSHOT_FILE, JSON.stringify(snapshots, null, 2), 'utf-8');
+    }
+    catch (e) {
+        logger_1.logger.debug('写入分析快照失败:', e);
+    }
+}
+/**
+ * 获取当前 HEAD 的 commit hash
+ */
+function getCurrentCommitHash() {
+    try {
+        return (0, child_process_1.execSync)('git rev-parse HEAD', {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取当前分支名
+ */
+function getCurrentBranch() {
+    try {
+        return (0, child_process_1.execSync)('git rev-parse --abbrev-ref HEAD', {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 基于上次分析的快照获取增量变更文件
+ * @param scope 分析范围标识（如 'global', 'Iteration-Q2', 'Task-001'）
+ * @returns 自上次分析以来的变更文件列表（无快照则 fallback 到默认分支对比）
+ */
+async function getIncrementalChangedFiles(scope) {
+    const snapshots = await readAnalysisSnapshots();
+    const snapshot = snapshots[scope];
+    if (!snapshot) {
+        logger_1.logger.debug(`变更感知: 未找到 ${scope} 的历史快照，fallback 到默认分支对比`);
+        return [...getChangedFiles(), ...getUntrackedFiles()];
+    }
+    // 检查上次分析的 commit 是否仍存在于当前分支历史中
+    const currentCommit = getCurrentCommitHash();
+    if (!currentCommit) {
+        logger_1.logger.warn('变更感知: 无法获取当前 commit hash');
+        return [];
+    }
+    if (snapshot.lastCommit === currentCommit) {
+        logger_1.logger.debug(`变更感知: ${scope} 自上次分析(${snapshot.lastCommit.slice(0, 7)})后无新变更`);
+        return [];
+    }
+    // 使用 git diff <lastCommit>..HEAD 获取增量变更
+    const files = getChangedFilesBetween(snapshot.lastCommit);
+    logger_1.logger.info(`🔄 变更感知(增量): ${scope} 自 ${snapshot.analyzedAt.slice(0, 10)} ` +
+        `(${snapshot.lastCommit.slice(0, 7)}..${currentCommit.slice(0, 7)}) ` +
+        `检测到 ${files.length} 个变更文件`);
+    return files;
+}
+/**
+ * 记录分析快照（分析完成后调用）
+ * @param scope 分析范围标识（如 'global', 'Iteration-Q2', 'Task-001'）
+ */
+async function recordAnalysisSnapshot(scope) {
+    const commitHash = getCurrentCommitHash();
+    const branch = getCurrentBranch();
+    if (!commitHash) {
+        logger_1.logger.warn('变更感知: 无法记录快照，当前不是 git 仓库');
+        return;
+    }
+    const snapshots = await readAnalysisSnapshots();
+    snapshots[scope] = {
+        lastCommit: commitHash,
+        analyzedAt: new Date().toISOString(),
+        branch: branch || 'unknown',
+    };
+    await writeAnalysisSnapshots(snapshots);
+    logger_1.logger.debug(`变更感知: 已记录 ${scope} 分析快照 → ${commitHash.slice(0, 7)} (${branch})`);
+}
+/**
+ * 清除指定范围的分析快照
+ * @param scope 分析范围标识，不传则清除全部
+ */
+async function clearAnalysisSnapshot(scope) {
+    if (scope) {
+        const snapshots = await readAnalysisSnapshots();
+        delete snapshots[scope];
+        await writeAnalysisSnapshots(snapshots);
+        logger_1.logger.info(`🗑️ 变更感知: 已清除 ${scope} 的分析快照`);
+    }
+    else {
+        try {
+            await (0, fs_extra_1.writeFile)(SNAPSHOT_FILE, '{}', 'utf-8');
+            logger_1.logger.info('🗑️ 变更感知: 已清除所有分析快照');
+        }
+        catch (e) {
+            logger_1.logger.debug('清除分析快照失败:', e);
+        }
+    }
+}
+//# sourceMappingURL=change-detection.js.map

package/dist/core/change-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-detection.js","sourceRoot":"","sources":["../../src/core/change-detection.ts"],"names":[],"mappings":"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"}

package/dist/core/knowledge-graph.d.ts

@@ -71,4 +71,30 @@ export declare function getTaskContext(graph: KnowledgeGraph, taskId: string): {
 export declare function isGraphStale(cwd: string, iteration?: string): Promise<boolean>;
 /** 刷新知识图谱（重建 + 保存）—— 供命令完成后调用 */
 export declare function refreshKnowledgeGraph(cwd: string, iteration?: string): Promise<KnowledgeGraph | null>;
+export interface DependencyChain {
+    taskId: string;
+    taskName: string;
+    depth: number;
+    path: string[];
+    relations: GraphRelation[];
+    entities: GraphEntity[];
+}
+/**
+ * 追踪任务的完整依赖链路（向上追溯）
+ * 递归追踪 implements → references → depends_on 关系
+ */
+export declare function traceDependencyChain(graph: KnowledgeGraph, taskId: string, maxDepth?: number, visited?: Set<string>): DependencyChain[];
+/**
+ * 获取任务的完整上下文（扩展版，包含依赖链路）
+ * 在 getTaskContext 基础上增加 dependencyChain 字段
+ */
+export declare function getFullTaskContext(graph: KnowledgeGraph, taskId: string): {
+    requirement: GraphEntity | null;
+    siblingSubtasks: GraphEntity[];
+    parentTask: GraphEntity | null;
+    relatedSpecs: GraphEntity[];
+    dependsOn: GraphEntity[];
+    dependencyChain: DependencyChain[];
+    downstreamTasks: GraphEntity[];
+};
 //# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/core/knowledge-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/core/knowledge-graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/core/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,iBAAiB,CAAC;IACjI,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,gBAAgB,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IACrN,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AA8kCD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CAiFzB;AAED,uBAAuB;AACvB,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5F;AAED,iBAAiB;AACjB;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkBpF;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG;IACrE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B,CAwDA;AAiCD,gCAAgC;AAChC,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BpF;AAED,iCAAiC;AACjC,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAShC;AAMD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAU,EACpB,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,eAAe,EAAE,CA2CnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG;IACzE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,eAAe,EAAE,WAAW,EAAE,CAAC;CAChC,CAwBA"}