speccore 5.71.0 → 5.74.0

package/dist/core/git-integration.js

@@ -7,6 +7,7 @@
  *  - Commit 消息自动生成
  *  - PR 描述自动生成
  *  - Git Hook 安装
+ *  - 保护分支拦截
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTaskBranch = createTaskBranch;
@@ -14,6 +15,8 @@ exports.detectDefaultBranch = detectDefaultBranch;
 exports.getCurrentTaskMapping = getCurrentTaskMapping;
 exports.generateCommitMessage = generateCommitMessage;
 exports.generatePRDescription = generatePRDescription;
+exports.getProtectedBranches = getProtectedBranches;
+exports.isProtectedBranch = isProtectedBranch;
 exports.installGitHooks = installGitHooks;
 exports.cleanStaleCache = cleanStaleCache;
 const fs_extra_1 = require("fs-extra");
@@ -147,6 +150,48 @@ function generatePRDescription(taskId, taskName) {
     ];
     return lines.join('\n');
 }
+/**
+ * 从 CONSTITUTION.md 读取保护分支列表
+ */
+function getProtectedBranches() {
+    try {
+        const constitutionPath = (0, path_1.join)('.speccore', 'CONSTITUTION.md');
+        if (!(0, fs_extra_1.existsSync)(constitutionPath))
+            return [];
+        const content = (0, fs_extra_1.readFileSync)(constitutionPath, 'utf-8');
+        const match = content.match(/保护分支[：:]\s*(.+)/);
+        if (!match)
+            return [];
+        return match[1]
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 检查分支是否为保护分支
+ * 支持精确匹配和通配符（如 release/*）
+ */
+function isProtectedBranch(branchName) {
+    const protected_ = getProtectedBranches();
+    for (const pattern of protected_) {
+        if (pattern.includes('*')) {
+            // 通配符匹配: release/* → release/1.0.0
+            const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+            if (regex.test(branchName))
+                return true;
+        }
+        else {
+            // 精确匹配
+            if (branchName === pattern)
+                return true;
+        }
+    }
+    return false;
+}
 /**
  * 安装 Git Hooks
  */
@@ -156,16 +201,68 @@ function installGitHooks() {
         throw new Error('Not a Git repository');
     }
     const hooksDir = (0, path_1.join)(gitDir, 'hooks');
-    // pre-commit: check spec annotations
+    // pre-commit: 保护分支检查 + spec annotations 检查
     const preCommitContent = `#!/bin/sh
 # SpecCore pre-commit hook
+
+# ── 1. 保护分支检查 ──
+CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+if [ -n "$CURRENT_BRANCH" ] && [ -f ".speccore/CONSTITUTION.md" ]; then
+  PROTECTED=$(grep '保护分支' .speccore/CONSTITUTION.md | sed 's/.*[：:]\\s*//' | tr ',' '\\n' | sed 's/^[ \\t]*//')
+  for PATTERN in $PROTECTED; do
+    # 精确匹配
+    if [ "$CURRENT_BRANCH" = "$PATTERN" ]; then
+      echo "❌ SpecCore: 保护分支 '$CURRENT_BRANCH' 禁止直接 commit"
+      echo "   请切换到 feature/ 分支或使用 PR 合并"
+      exit 1
+    fi
+    # 通配符匹配 (release/* → release/xxx)
+    case "$PATTERN" in
+      *"*"*)
+        REGEX=$(echo "$PATTERN" | sed 's/\\*/.*/')
+        if echo "$CURRENT_BRANCH" | grep -qE "^\${REGEX}$"; then
+          echo "❌ SpecCore: 保护分支 '$CURRENT_BRANCH' 匹配保护规则 '$PATTERN'，禁止直接 commit"
+          echo "   请切换到 feature/ 分支或使用 PR 合并"
+          exit 1
+        fi
+        ;;
+    esac
+  done
+fi
+
+# ── 2. Spec annotations 检查 ──
 echo "🔍 SpecCore: Checking @spec annotations..."
 git diff --cached --name-only | grep -q "@spec" && echo "✅ Spec annotations found" || true
 `;
     (0, fs_extra_1.writeFileSync)((0, path_1.join)(hooksDir, 'pre-commit'), preCommitContent, { mode: 0o755 });
-    // pre-push: run validate
+    // pre-push: 保护分支检查 + validate
     const prePushContent = `#!/bin/sh
 # SpecCore pre-push hook
+
+# ── 1. 保护分支检查 ──
+CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+if [ -n "$CURRENT_BRANCH" ] && [ -f ".speccore/CONSTITUTION.md" ]; then
+  PROTECTED=$(grep '保护分支' .speccore/CONSTITUTION.md | sed 's/.*[：:]\\s*//' | tr ',' '\\n' | sed 's/^[ \\t]*//')
+  for PATTERN in $PROTECTED; do
+    if [ "$CURRENT_BRANCH" = "$PATTERN" ]; then
+      echo "❌ SpecCore: 保护分支 '$CURRENT_BRANCH' 禁止 push"
+      echo "   请通过 PR 合并代码"
+      exit 1
+    fi
+    case "$PATTERN" in
+      *"*"*)
+        REGEX=$(echo "$PATTERN" | sed 's/\\*/.*/')
+        if echo "$CURRENT_BRANCH" | grep -qE "^\${REGEX}$"; then
+          echo "❌ SpecCore: 保护分支 '$CURRENT_BRANCH' 匹配保护规则 '$PATTERN'，禁止 push"
+          echo "   请通过 PR 合并代码"
+          exit 1
+        fi
+        ;;
+    esac
+  done
+fi
+
+# ── 2. Spec 验证 ──
 echo "🔍 SpecCore: Validating specs..."
 speccore validate --warn-only
 `;

package/dist/core/git-integration.js.map

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

package/dist/core/inbox.d.ts

@@ -0,0 +1,120 @@
+export interface InboxFileEntry {
+    name: string;
+    path: string;
+    size: number;
+    mtime: string;
+    type: 'text' | 'excel' | 'image' | 'other';
+    content: string;
+}
+export interface InboxScanResult {
+    newFiles: InboxFileEntry[];
+    modifiedFiles: InboxFileEntry[];
+    skippedFiles: string[];
+    allFiles: InboxFileEntry[];
+}
+export interface ManifestEntry {
+    processedAt: string;
+    mtime: string;
+    linkedTo: string[];
+    action: 'change' | 'new' | 'unknown';
+}
+export interface InboxManifest {
+    files: Record<string, ManifestEntry>;
+    lastScan: string;
+}
+/** 单个任务的影响分析结果 */
+export interface TaskImpact {
+    id: string;
+    name: string;
+    status: string;
+    level: 'direct' | 'indirect' | 'none';
+    reason: string;
+    affectedFiles: string[];
+    needReExecute: boolean;
+    needRegression: boolean;
+}
+/** 结构化影响分析报告 */
+export interface ImpactReport {
+    directTasks: TaskImpact[];
+    indirectTasks: TaskImpact[];
+    unaffectedTasks: TaskImpact[];
+}
+/**
+ * 获取 inbox 目录绝对路径
+ */
+export declare function getInboxDir(): string;
+/**
+ * 确保 inbox 目录存在
+ */
+export declare function ensureInboxDir(): Promise<void>;
+/**
+ * 读取 manifest
+ */
+export declare function readManifest(): Promise<InboxManifest>;
+/**
+ * 写入 manifest
+ */
+export declare function writeManifest(manifest: InboxManifest): Promise<void>;
+/**
+ * 扫描 inbox 目录，区分新文件/已修改/已处理
+ */
+export declare function scanInbox(options?: {
+    reprocess?: boolean;
+}): Promise<InboxScanResult>;
+/**
+ * 更新 manifest：标记文件已处理
+ */
+export declare function markProcessed(files: InboxFileEntry[], action: 'change' | 'new', linkedTo?: string[]): Promise<void>;
+/**
+ * 清理 manifest 中已不存在的文件记录
+ */
+export declare function cleanManifest(): Promise<number>;
+/**
+ * 格式化 inbox 扫描结果为终端输出
+ */
+export declare function logInboxScan(result: InboxScanResult): void;
+/**
+ * 构建澄清 Prompt：将用户描述 + 文件内容 + 任务详细上下文组合为结构化 Prompt
+ * taskDetails 包含每个任务的 REQ 摘要、TECH 摘要、状态、依赖关系
+ */
+export declare function buildClarifyPrompt(desc: string, files: InboxFileEntry[], taskDetails: {
+    id: string;
+    name: string;
+    reqSummary: string;
+    techSummary: string;
+    status: string;
+    dependencies: string[];
+}[]): string;
+/** 解析澄清响应的返回类型 */
+export interface ClarifyResult {
+    intent: 'change' | 'new';
+    structuredDesc: string;
+    keyPoints: string[];
+    acceptanceCriteria: string[];
+    impactReport: {
+        directTasks: {
+            id: string;
+            reason: string;
+            affectedFiles: string[];
+        }[];
+        indirectTasks: {
+            id: string;
+            reason: string;
+        }[];
+        unaffectedTasks: string[];
+    };
+    suggestedActions: string[];
+}
+/**
+ * 解析澄清响应（AI 返回的 JSON）
+ */
+export declare function parseClarifyResponse(response: string): ClarifyResult | null;
+/**
+ * 格式化澄清结果为终端展示（含结构化影响范围）
+ */
+export declare function logClarifyResult(result: ClarifyResult): void;
+/**
+ * 格式化影响分析报告为终端展示（本地分析结果）
+ */
+export declare function logImpactReport(report: ImpactReport): void;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/core/inbox.d.ts.map

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

package/dist/core/inbox.js

@@ -0,0 +1,377 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInboxDir = getInboxDir;
+exports.ensureInboxDir = ensureInboxDir;
+exports.readManifest = readManifest;
+exports.writeManifest = writeManifest;
+exports.scanInbox = scanInbox;
+exports.markProcessed = markProcessed;
+exports.cleanManifest = cleanManifest;
+exports.logInboxScan = logInboxScan;
+exports.buildClarifyPrompt = buildClarifyPrompt;
+exports.parseClarifyResponse = parseClarifyResponse;
+exports.logClarifyResult = logClarifyResult;
+exports.logImpactReport = logImpactReport;
+/**
+ * inbox — 需求收件箱
+ * 管理 .speccore/inbox/ 目录：扫描新文件、追踪处理状态、读取文件内容
+ */
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+const logger_1 = require("../utils/logger");
+// ── 常量 ──
+const INBOX_DIR = '.speccore/inbox';
+const MANIFEST_FILE = '.manifest.json';
+// ── 核心函数 ──
+/**
+ * 获取 inbox 目录绝对路径
+ */
+function getInboxDir() {
+    return (0, path_1.join)(process.cwd(), INBOX_DIR);
+}
+/**
+ * 确保 inbox 目录存在
+ */
+async function ensureInboxDir() {
+    await (0, fs_extra_1.ensureDir)(getInboxDir());
+}
+/**
+ * 读取 manifest
+ */
+async function readManifest() {
+    const manifestPath = (0, path_1.join)(getInboxDir(), MANIFEST_FILE);
+    if (await (0, fs_extra_1.pathExists)(manifestPath)) {
+        try {
+            const content = await (0, fs_extra_1.readFile)(manifestPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return { files: {}, lastScan: '' };
+        }
+    }
+    return { files: {}, lastScan: '' };
+}
+/**
+ * 写入 manifest
+ */
+async function writeManifest(manifest) {
+    const manifestPath = (0, path_1.join)(getInboxDir(), MANIFEST_FILE);
+    manifest.lastScan = new Date().toISOString();
+    await (0, fs_extra_1.writeFile)(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+}
+/**
+ * 检测文件类型
+ */
+function detectFileType(name) {
+    const ext = name.split('.').pop()?.toLowerCase() || '';
+    if (['md', 'txt', 'markdown', 'json', 'yaml', 'yml', 'csv'].includes(ext))
+        return 'text';
+    if (['xlsx', 'xls'].includes(ext))
+        return 'excel';
+    if (['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg'].includes(ext))
+        return 'image';
+    return 'other';
+}
+/**
+ * 读取单个文件内容
+ */
+async function readInboxFile(filePath, fileType) {
+    switch (fileType) {
+        case 'text':
+            return (0, fs_extra_1.readFile)(filePath, 'utf-8');
+        case 'excel':
+            try {
+                const XLSX = require('xlsx');
+                const wb = XLSX.readFile(filePath);
+                const sheets = [];
+                for (const name of wb.SheetNames) {
+                    const ws = wb.Sheets[name];
+                    const csv = XLSX.utils.sheet_to_csv(ws);
+                    sheets.push(`## Sheet: ${name}\n${csv}`);
+                }
+                return sheets.join('\n\n');
+            }
+            catch (e) {
+                return `[Excel 解析失败: ${filePath}]`;
+            }
+        case 'image':
+            // 图片无法直接读取文本，返回路径引用
+            return `[图片文件: ${filePath}]`;
+        case 'other':
+            try {
+                return await (0, fs_extra_1.readFile)(filePath, 'utf-8');
+            }
+            catch {
+                return `[无法读取: ${filePath}]`;
+            }
+    }
+}
+/**
+ * 扫描 inbox 目录，区分新文件/已修改/已处理
+ */
+async function scanInbox(options = {}) {
+    const inboxDir = getInboxDir();
+    if (!await (0, fs_extra_1.pathExists)(inboxDir)) {
+        return { newFiles: [], modifiedFiles: [], skippedFiles: [], allFiles: [] };
+    }
+    const manifest = await readManifest();
+    const entries = await (0, fs_extra_1.readdir)(inboxDir, { withFileTypes: true });
+    const result = { newFiles: [], modifiedFiles: [], skippedFiles: [], allFiles: [] };
+    for (const entry of entries) {
+        if (!entry.isFile() || entry.name.startsWith('.'))
+            continue;
+        const filePath = (0, path_1.join)(inboxDir, entry.name);
+        const fileType = detectFileType(entry.name);
+        const fileStat = await (0, fs_extra_1.stat)(filePath);
+        const mtime = fileStat.mtime.toISOString();
+        const fileEntry = {
+            name: entry.name,
+            path: filePath,
+            size: fileStat.size,
+            mtime,
+            type: fileType,
+            content: '',
+        };
+        // 检查 manifest 状态
+        const manifestEntry = manifest.files[entry.name];
+        if (options.reprocess || !manifestEntry) {
+            // 新文件 或 强制重新处理
+            fileEntry.content = await readInboxFile(filePath, fileType);
+            if (manifestEntry) {
+                result.modifiedFiles.push(fileEntry);
+            }
+            else {
+                result.newFiles.push(fileEntry);
+            }
+        }
+        else if (manifestEntry.mtime !== mtime) {
+            // 文件已修改
+            fileEntry.content = await readInboxFile(filePath, fileType);
+            result.modifiedFiles.push(fileEntry);
+        }
+        else {
+            // 已处理且未修改 → 跳过
+            result.skippedFiles.push(entry.name);
+        }
+        result.allFiles.push(fileEntry);
+    }
+    return result;
+}
+/**
+ * 更新 manifest：标记文件已处理
+ */
+async function markProcessed(files, action, linkedTo = []) {
+    const manifest = await readManifest();
+    for (const file of files) {
+        manifest.files[file.name] = {
+            processedAt: new Date().toISOString(),
+            mtime: file.mtime,
+            linkedTo,
+            action,
+        };
+    }
+    await writeManifest(manifest);
+}
+/**
+ * 清理 manifest 中已不存在的文件记录
+ */
+async function cleanManifest() {
+    const manifest = await readManifest();
+    const inboxDir = getInboxDir();
+    let cleaned = 0;
+    for (const name of Object.keys(manifest.files)) {
+        if (!await (0, fs_extra_1.pathExists)((0, path_1.join)(inboxDir, name))) {
+            delete manifest.files[name];
+            cleaned++;
+        }
+    }
+    if (cleaned > 0)
+        await writeManifest(manifest);
+    return cleaned;
+}
+/**
+ * 格式化 inbox 扫描结果为终端输出
+ */
+function logInboxScan(result) {
+    const total = result.newFiles.length + result.modifiedFiles.length + result.skippedFiles.length;
+    if (total === 0) {
+        logger_1.logger.info('📎 Inbox: 目录为空');
+        return;
+    }
+    logger_1.logger.info('📎 Inbox 扫描:');
+    for (const f of result.newFiles) {
+        const size = f.size > 1024 ? `${(f.size / 1024).toFixed(1)}KB` : `${f.size}B`;
+        logger_1.logger.info(`   🆕 ${f.name} (新文件, ${size})`);
+    }
+    for (const f of result.modifiedFiles) {
+        const size = f.size > 1024 ? `${(f.size / 1024).toFixed(1)}KB` : `${f.size}B`;
+        logger_1.logger.info(`   🔄 ${f.name} (已修改, ${size})`);
+    }
+    for (const name of result.skippedFiles) {
+        logger_1.logger.info(`   ✅ ${name} (已处理 → 跳过)`);
+    }
+    const actionable = result.newFiles.length + result.modifiedFiles.length;
+    if (actionable === 0) {
+        logger_1.logger.info('');
+        logger_1.logger.info('   所有文件已处理。请添加新文件或使用 --file 指定');
+    }
+}
+/**
+ * 构建澄清 Prompt：将用户描述 + 文件内容 + 任务详细上下文组合为结构化 Prompt
+ * taskDetails 包含每个任务的 REQ 摘要、TECH 摘要、状态、依赖关系
+ */
+function buildClarifyPrompt(desc, files, taskDetails) {
+    const sections = [];
+    sections.push('# 需求澄清与影响分析');
+    sections.push('');
+    sections.push('## 用户输入');
+    sections.push(`原始描述: ${desc}`);
+    sections.push('');
+    // 附件内容
+    if (files.length > 0) {
+        sections.push('## 附件内容');
+        for (const f of files) {
+            if (f.type === 'image') {
+                sections.push(`### ${f.name}`);
+                sections.push(`[图片: ${f.path}]`);
+            }
+            else {
+                sections.push(`### ${f.name}`);
+                sections.push(f.content.slice(0, 5000));
+                if (f.content.length > 5000) {
+                    sections.push(`... (内容截断，共 ${f.content.length} 字符)`);
+                }
+            }
+            sections.push('');
+        }
+    }
+    // 现有任务详细上下文
+    if (taskDetails.length > 0) {
+        sections.push('## 现有任务详情');
+        for (const t of taskDetails) {
+            sections.push(`### ${t.id}: ${t.name}`);
+            sections.push(`- 状态: ${t.status}`);
+            if (t.reqSummary)
+                sections.push(`- 需求摘要: ${t.reqSummary}`);
+            if (t.techSummary)
+                sections.push(`- 技术方案摘要: ${t.techSummary}`);
+            if (t.dependencies.length > 0)
+                sections.push(`- 依赖: ${t.dependencies.join(', ')}`);
+            sections.push('');
+        }
+    }
+    // 输出要求
+    sections.push('## 请分析并输出 JSON:');
+    sections.push('```json');
+    sections.push('{');
+    sections.push('  "intent": "change | new",');
+    sections.push('  "structuredDesc": "结构化需求描述",');
+    sections.push('  "keyPoints": ["要点1", "要点2"],');
+    sections.push('  "acceptanceCriteria": ["验收标准1", "验收标准2"],');
+    sections.push('  "impactReport": {');
+    sections.push('    "directTasks": [{ "id": "Task-003", "reason": "密码规则在该任务中定义", "affectedFiles": ["REQ.md", "TECH.md"] }],');
+    sections.push('    "indirectTasks": [{ "id": "Task-005", "reason": "依赖 Task-003 的密码校验逻辑" }],');
+    sections.push('    "unaffectedTasks": ["Task-001", "Task-002"]');
+    sections.push('  },');
+    sections.push('  "suggestedActions": ["修改 Task-003 密码字段定义", "回归测试 Task-005 登录流程"]');
+    sections.push('}');
+    sections.push('```');
+    return sections.join('\n');
+}
+/**
+ * 解析澄清响应（AI 返回的 JSON）
+ */
+function parseClarifyResponse(response) {
+    try {
+        const jsonMatch = response.match(/```(?:json)?\s*([\s\S]*?)```/);
+        const jsonStr = jsonMatch ? jsonMatch[1].trim() : response.trim();
+        return JSON.parse(jsonStr);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 格式化澄清结果为终端展示（含结构化影响范围）
+ */
+function logClarifyResult(result) {
+    logger_1.logger.info('');
+    logger_1.logger.info('📋 需求澄清结果:');
+    logger_1.logger.info('┌─────────────────────────────────────┐');
+    logger_1.logger.info(`│ 意图: ${result.intent === 'new' ? '🆕 新增（全新功能）' : '🔄 变更（修改已有需求）'}`);
+    logger_1.logger.info(`│ 结构化描述: ${result.structuredDesc}`);
+    if (result.keyPoints.length > 0) {
+        logger_1.logger.info('│ 功能要点:');
+        for (const p of result.keyPoints) {
+            logger_1.logger.info(`│   • ${p}`);
+        }
+    }
+    if (result.acceptanceCriteria.length > 0) {
+        logger_1.logger.info('│ 验收标准:');
+        for (const c of result.acceptanceCriteria) {
+            logger_1.logger.info(`│   ✓ ${c}`);
+        }
+    }
+    logger_1.logger.info('│');
+    // 结构化影响范围
+    if (result.impactReport) {
+        const { directTasks, indirectTasks, unaffectedTasks } = result.impactReport;
+        if (directTasks.length > 0) {
+            logger_1.logger.info('│ 🔴 直接影响（需修改 Spec + 重新执行）:');
+            for (const t of directTasks) {
+                const files = t.affectedFiles?.length ? ` [${t.affectedFiles.join(', ')}]` : '';
+                logger_1.logger.info(`│   ${t.id}${files} — ${t.reason}`);
+            }
+        }
+        if (indirectTasks.length > 0) {
+            logger_1.logger.info('│ 🟡 间接影响（需回归验证）:');
+            for (const t of indirectTasks) {
+                logger_1.logger.info(`│   ${t.id} — ${t.reason}`);
+            }
+        }
+        if (unaffectedTasks.length > 0) {
+            logger_1.logger.info(`│ 🟢 无影响: ${unaffectedTasks.join(', ')}`);
+        }
+    }
+    if (result.suggestedActions?.length > 0) {
+        logger_1.logger.info('│ 建议操作:');
+        for (const a of result.suggestedActions) {
+            logger_1.logger.info(`│   → ${a}`);
+        }
+    }
+    logger_1.logger.info('└─────────────────────────────────────┘');
+}
+/**
+ * 格式化影响分析报告为终端展示（本地分析结果）
+ */
+function logImpactReport(report) {
+    logger_1.logger.info('');
+    logger_1.logger.info('📋 影响范围分析:');
+    logger_1.logger.info('┌─────────────────────────────────────┐');
+    if (report.directTasks.length > 0) {
+        logger_1.logger.info('│ 🔴 直接影响（需修改 Spec + 重新执行）:');
+        for (const t of report.directTasks) {
+            const statusTag = t.status === 'done' ? ' [done→needs-rework]' : ` [${t.status}]`;
+            logger_1.logger.info(`│   ${t.id} ${t.name}${statusTag}`);
+            logger_1.logger.info(`│     ${t.reason}`);
+            if (t.affectedFiles.length > 0) {
+                logger_1.logger.info(`│     受影响文件: ${t.affectedFiles.join(', ')}`);
+            }
+        }
+    }
+    if (report.indirectTasks.length > 0) {
+        logger_1.logger.info('│');
+        logger_1.logger.info('│ 🟡 间接影响（需回归验证）:');
+        for (const t of report.indirectTasks) {
+            const statusTag = t.status === 'done' ? ' [需回归测试]' : ` [${t.status}]`;
+            logger_1.logger.info(`│   ${t.id} ${t.name}${statusTag}`);
+            logger_1.logger.info(`│     ${t.reason}`);
+        }
+    }
+    if (report.unaffectedTasks.length > 0) {
+        logger_1.logger.info('│');
+        logger_1.logger.info(`│ 🟢 无影响: ${report.unaffectedTasks.map(t => t.id).join(', ')}`);
+    }
+    logger_1.logger.info('└─────────────────────────────────────┘');
+}
+//# sourceMappingURL=inbox.js.map