speccore 8.3.285 → 8.3.295

package/dist/commands/status-panel.js

@@ -85,7 +85,7 @@ async function statusPanelCommand(options = {}) {
     logger_1.logger.info(`│ 项目: ${projectConfig.project.name.padEnd(37)}│`);
     if (iteration) {
         logger_1.logger.info(`│ 迭代: ${iteration.padEnd(37)}│`);
-        const iterDir = `Iteration-${iteration}`;
+        const iterDir = resolveIterDir(iteration);
         // Phase detection
         const phase = await detectPhase(iterDir);
         const phaseIcon = { init: '🔧', require: '📝', analyze: '🔍', split: '📦', dev: '💻', review: '✅', done: '✨' }[phase] || '📌';
@@ -130,6 +130,37 @@ async function statusPanelCommand(options = {}) {
                     logger_1.logger.info(`│ ${name}: ${pBar} ${s.done}/${s.total}`.padEnd(47) + '│');
                 }
             }
+            // v8.3.288+: 模块统计（按 .meta/feature 分组，精确到功能模块）
+            const moduleStats = buildModuleStats(tasks);
+            if (Object.keys(moduleStats).length > 0) {
+                logger_1.logger.info('├──────────────────────────────────────────────┤');
+                logger_1.logger.info('│ 模块统计:'.padEnd(47) + '│');
+                for (const [name, s] of Object.entries(moduleStats)
+                    .sort((a, b) => b[1].total - a[1].total)) {
+                    const pBar = buildProgressBar(s.done, s.total);
+                    logger_1.logger.info(`│  ${name}: ${pBar} ${s.done}/${s.total}`.padEnd(47) + '│');
+                }
+            }
+            // v8.3.293+: 逻辑分组视图（方案 A）——按 .meta/feature 分组列出任务清单，
+            // 解决 bugfix 任务平铺目录下 bug 多不便浏览的问题（元数据分组，不改变物理目录）。
+            // 触发：--group-by feature 显式启用；或 --type bugfix 时自动启用。
+            const groupByFeature = options.groupBy === 'feature' || (options.type || '').toLowerCase() === 'bugfix';
+            if (groupByFeature && Object.keys(moduleStats).length > 0) {
+                logger_1.logger.info('├──────────────────────────────────────────────┤');
+                logger_1.logger.info('│ 模块清单:'.padEnd(47) + '│');
+                const grouped = groupTasksByFeature(tasks);
+                for (const [feature, list] of grouped) {
+                    const s = moduleStats[feature] || { total: list.length, done: 0 };
+                    const name = feature.length > 16 ? feature.slice(0, 15) + '…' : feature;
+                    logger_1.logger.info(`│  ▸ ${name}（${s.done}/${s.total}）`.padEnd(47) + '│');
+                    for (const t of list) {
+                        const icon = statusIconFor(t.status);
+                        const who = t.assignee ? ` · ${t.assignee}` : '';
+                        const line = `    ${icon} ${t.id} [${t.status}]${who}`;
+                        logger_1.logger.info(`│${line.slice(0, 45).padEnd(46)}│`);
+                    }
+                }
+            }
             // Platform breakdown
             const platformCount = await countPlatforms(iterDir, tasks);
             if (platformCount.backend + platformCount.frontend > 0) {
@@ -163,40 +194,113 @@ async function statusPanelCommand(options = {}) {
     logger_1.logger.info('└──────────────────────────────────────────────┘');
     logger_1.logger.info('');
 }
+// ── 共享：迭代目录归一化（context.json 存全名 Iteration-NNN，视图内只加一次前缀）──
+function resolveIterDir(iteration) {
+    return iteration.startsWith('Iteration-') ? iteration : `Iteration-${iteration}`;
+}
 // ── 共享：收集所有任务数据 ──
 async function collectTasks(iterDir) {
     const tasks = [];
     if (!(await (0, fs_extra_1.pathExists)(iterDir)))
         return tasks;
-    const entryList = await (0, fs_extra_1.readdir)(iterDir, { withFileTypes: true });
-    for (const e of entryList) {
-        if (e.isDirectory() && e.name.startsWith('Task-')) {
-            const taskPath = (0, path_1.join)(iterDir, e.name, '00-specs', 'TASK.md');
-            try {
-                if (await (0, fs_extra_1.pathExists)(taskPath)) {
-                    const md = await (0, fs_extra_1.readFile)(taskPath, 'utf-8');
-                    const status = (md.match(/状态: (.+)/) || [])[1] || 'pending';
-                    const type = (md.match(/类型: (.+)/) || [])[1] || 'feature';
-                    const assignee = (md.match(/负责人[：:]\s*(\S+)/) || [])[1] || '';
-                    tasks.push({ id: e.name, status, type, assignee });
+    // v8.3.288+: 扫描根级 + 030-tasks/{type}/ 两种布局（task new 建在 030-tasks/{type}/ 下，
+    // 此前只扫根级导致导入的 bug 任务在面板隐形，模块统计为空）
+    const roots = [iterDir];
+    const tasksDir = (0, path_1.join)(iterDir, '030-tasks');
+    if (await (0, fs_extra_1.pathExists)(tasksDir)) {
+        const subEntries = await (0, fs_extra_1.readdir)(tasksDir, { withFileTypes: true });
+        for (const se of subEntries) {
+            if (se.isDirectory())
+                roots.push((0, path_1.join)(tasksDir, se.name));
+        }
+    }
+    for (const root of roots) {
+        const entryList = await (0, fs_extra_1.readdir)(root, { withFileTypes: true });
+        for (const e of entryList) {
+            if (e.isDirectory() && e.name.startsWith('Task-')) {
+                const taskDir = (0, path_1.join)(root, e.name);
+                // v8.3.288+: .meta 优先（task new 任务无 00-specs/TASK.md，状态/类型/模块都在 .meta）
+                let feature = '';
+                let metaStatus = '';
+                let metaType = '';
+                try {
+                    const featurePath = (0, path_1.join)(taskDir, '.meta', 'feature');
+                    if (await (0, fs_extra_1.pathExists)(featurePath))
+                        feature = (await (0, fs_extra_1.readFile)(featurePath, 'utf-8')).trim();
+                    const statusPath = (0, path_1.join)(taskDir, '.meta', 'status');
+                    if (await (0, fs_extra_1.pathExists)(statusPath))
+                        metaStatus = (await (0, fs_extra_1.readFile)(statusPath, 'utf-8')).trim();
+                    const typePath = (0, path_1.join)(taskDir, '.meta', 'type');
+                    if (await (0, fs_extra_1.pathExists)(typePath))
+                        metaType = (await (0, fs_extra_1.readFile)(typePath, 'utf-8')).trim();
                 }
-                else {
-                    tasks.push({ id: e.name, status: 'pending', type: 'feature', assignee: '' });
+                catch { }
+                const taskPath = (0, path_1.join)(taskDir, '00-specs', 'TASK.md');
+                try {
+                    if (await (0, fs_extra_1.pathExists)(taskPath)) {
+                        const md = await (0, fs_extra_1.readFile)(taskPath, 'utf-8');
+                        const status = metaStatus || (md.match(/状态: (.+)/) || [])[1] || 'pending';
+                        const type = metaType || (md.match(/类型: (.+)/) || [])[1] || 'feature';
+                        const assignee = (md.match(/负责人[：:]\s*(\S+)/) || [])[1] || '';
+                        tasks.push({ id: e.name, status, type, assignee, feature, dir: taskDir });
+                    }
+                    else {
+                        tasks.push({ id: e.name, status: metaStatus || 'pending', type: metaType || 'feature', assignee: '', feature, dir: taskDir });
+                    }
+                }
+                catch {
+                    tasks.push({ id: e.name, status: metaStatus || 'pending', type: metaType || 'feature', assignee: '', feature, dir: taskDir });
                 }
-            }
-            catch {
-                tasks.push({ id: e.name, status: 'pending', type: 'feature', assignee: '' });
             }
         }
     }
     return tasks;
 }
+// v8.3.288+: 按功能模块分组统计（模块 × 任务数/完成数），供看板与终端精确呈现
+function buildModuleStats(tasks) {
+    const stats = {};
+    for (const t of tasks) {
+        const feature = (t.feature || '未分类').trim() || '未分类';
+        if (!stats[feature])
+            stats[feature] = { total: 0, done: 0 };
+        stats[feature].total++;
+        if (t.status.includes('completed') || t.status.includes('完成'))
+            stats[feature].done++;
+    }
+    return stats;
+}
+// v8.3.293+: 任务按功能模块分组（组按任务数降序，组内按任务 ID 排序），供逻辑分组视图使用
+function groupTasksByFeature(tasks) {
+    const groups = new Map();
+    for (const t of tasks) {
+        const feature = (t.feature || '未分类').trim() || '未分类';
+        if (!groups.has(feature))
+            groups.set(feature, []);
+        groups.get(feature).push(t);
+    }
+    return [...groups.entries()]
+        .sort((a, b) => b[1].length - a[1].length)
+        .map(([feature, list]) => [feature, list.sort((x, y) => (x.id < y.id ? -1 : x.id > y.id ? 1 : 0))]);
+}
+// v8.3.293+: 任务状态 → 终端图标（与生命周期看板同色系）
+function statusIconFor(status) {
+    const st = status || '';
+    if (/完成|completed|done/i.test(st))
+        return '🟢';
+    if (/开发|doing|in_progress|进行/i.test(st))
+        return '🔵';
+    if (/测试|testing/i.test(st))
+        return '🟡';
+    if (/审查|review/i.test(st))
+        return '🟣';
+    return '🔲';
+}
 // ── 共享：按平台统计 ──
 async function countPlatforms(iterDir, tasks) {
     let backend = 0, frontend = 0;
     for (const t of tasks) {
         try {
-            const entries = await (0, fs_extra_1.readdir)((0, path_1.join)(iterDir, t.id), { withFileTypes: true });
+            const entries = await (0, fs_extra_1.readdir)(t.dir || (0, path_1.join)(iterDir, t.id), { withFileTypes: true });
             if (entries.some((e) => e.name === 'backend'))
                 backend++;
             if (entries.some((e) => e.name === 'frontend'))
@@ -306,7 +410,7 @@ async function filterByPlatform(iterDir, tasks, platform) {
     const { join } = require('path');
     const result = [];
     for (const t of tasks) {
-        const taskDir = join(iterDir, t.id);
+        const taskDir = t.dir || join(iterDir, t.id);
         try {
             const entries = await readdir(taskDir, { withFileTypes: true });
             if (platform === 'backend' && entries.some((e) => e.name === 'backend'))
@@ -328,7 +432,7 @@ async function exportStatus(config, projectConfig, iteration, format, options =
         phases: {},
     };
     if (iteration) {
-        const iterDir = (0, path_1.join)(process.cwd(), 'Iteration-' + iteration);
+        const iterDir = (0, path_1.join)(process.cwd(), resolveIterDir(iteration));
         const phase = await require('./status-panel').defaultPhase(iterDir);
         data.phase = phase;
         // ── 读取迭代时间范围 ──
@@ -380,23 +484,25 @@ async function exportStatus(config, projectConfig, iteration, format, options =
         }
         const tasks = [];
         if (await (0, fs_extra_1.pathExists)(iterDir)) {
-            const entryList = await (0, fs_extra_1.readdir)(iterDir, { withFileTypes: true });
-            for (const e of entryList) {
-                if (e.isDirectory() && e.name.startsWith('Task-')) {
-                    const taskPath = (0, path_1.join)(iterDir, e.name, '00-specs', 'TASK.md');
+            // v8.3.288+: 复用 collectTasks 多根扫描（含 030-tasks/{type}/ 布局与 .meta/feature），
+            // 此前只扫迭代根级导致 task new 导入的 bug 任务在看板隐形
+            const base = await collectTasks(iterDir);
+            for (const t of base) {
+                const item = { id: t.id, status: t.status, type: t.type, assignee: t.assignee || '', feature: t.feature, created: '', estimate: 0, delay: false };
+                // 补读 00-specs/TASK.md 的扩展字段（task new 任务无此文件，保持空值）
+                try {
+                    const taskPath = (0, path_1.join)(t.dir, '00-specs', 'TASK.md');
                     if (await (0, fs_extra_1.pathExists)(taskPath)) {
                         const md = await (0, fs_extra_1.readFile)(taskPath, 'utf-8');
-                        const status = (md.match(/状态: (.+)/) || [])[1] || 'pending';
-                        const type = (md.match(/类型: (.+)/) || [])[1] || 'feature';
-                        const created = (md.match(/创建日期[：:]?\s*(\d{4}-\d{2}-\d{2})/) || md.match(/创建:\s*(\d{4}-\d{2}-\d{2})/) || [])[1] || '';
+                        item.created = (md.match(/创建日期[：:]?\s*(\d{4}-\d{2}-\d{2})/) || md.match(/创建:\s*(\d{4}-\d{2}-\d{2})/) || [])[1] || '';
                         const estimate = (md.match(/预估[工时:：]?\s*(\d+)\s*[hH小时]/) || md.match(/预计耗时[：:]?\s*(\d+)/) || [])[1] || '';
-                        const delay = (md.match(/延期\|DELAY/i) || []).length > 0;
-                        tasks.push({ id: e.name, status, type, created, estimate: estimate ? parseInt(estimate) : 0, delay, assignee: (md.match(/负责人[：:]\s*(\S+)/) || [])[1] || '' });
-                    }
-                    else {
-                        tasks.push({ id: e.name, status: 'pending' });
+                        item.estimate = estimate ? parseInt(estimate, 10) : 0;
+                        item.delay = (md.match(/延期\|DELAY/i) || []).length > 0;
+                        item.assignee = item.assignee || (md.match(/负责人[：:]\s*(\S+)/) || [])[1] || '';
                     }
                 }
+                catch { }
+                tasks.push(item);
             }
         }
         data.tasks = tasks;
@@ -481,6 +587,7 @@ async function exportStatus(config, projectConfig, iteration, format, options =
                     pd2[t.assignee].features++;
                 pd2[t.assignee].estHours += t.estimate || 0;
             }
+            data.moduleStats = buildModuleStats(filtered);
             // 人员→平台映射
             data.personPlatforms = await buildPersonPlatforms(iterDir, filtered);
             data.personDetail = pd2;
@@ -523,6 +630,8 @@ async function exportStatus(config, projectConfig, iteration, format, options =
                 personDetail[t.assignee].estHours += t.estimate || 0;
             }
             data.personDetail = personDetail;
+            // v8.3.288+: 模块统计（按 .meta/feature 分组）
+            data.moduleStats = buildModuleStats(tasks);
             // 人员→平台映射
             data.personPlatforms = await buildPersonPlatforms(iterDir, tasks);
             // 每人任务清单
@@ -603,7 +712,7 @@ async function buildPersonPlatforms(iterDir, tasks) {
         if (!t.assignee || map[t.assignee])
             continue;
         try {
-            const entries = await readdir(join(iterDir, t.id), { withFileTypes: true });
+            const entries = await readdir(t.dir || join(iterDir, t.id), { withFileTypes: true });
             const platforms = [];
             // 扫描平铺的端目录
             const { parsePlatformList } = await Promise.resolve().then(() => __importStar(require('../core/spec-paths')));
@@ -664,6 +773,18 @@ function buildHtmlDashboard(data) {
             '</div>';
     }).join('');
     const hasAssignees = assigneeCards.length > 0;
+    // v8.3.288+: 模块统计（按 .meta/feature 分组，供精确项目统计）
+    const moduleStats = data.moduleStats || {};
+    const moduleRows = Object.entries(moduleStats)
+        .sort((a, b) => b[1].total - a[1].total)
+        .map(([name, s]) => {
+        const pct = s.total > 0 ? Math.round(s.done / s.total * 100) : 0;
+        const barW = s.total > 0 ? Math.round(s.done / s.total * 100) : 0;
+        return '<tr><td style="font-weight:600">' + name + '</td><td>' + s.total + '</td><td>' + s.done + '</td>' +
+            '<td><span style="color:' + (pct === 100 ? 'var(--green)' : 'var(--cyan)') + '">' + pct + '%</span></td>' +
+            '<td><div style="height:4px;background:rgba(255,255,255,.05);border-radius:2px;overflow:hidden;width:120px">' +
+            '<div style="width:' + barW + '%;height:100%;background:linear-gradient(90deg,var(--cyan),var(--green))"></div></div></td></tr>';
+    }).join('');
     const totalAi = data.totalAiTime || 0;
     const totalHuman = data.totalHumanTime || 0;
     const totalReview = data.totalReviewTime || 0;
@@ -1174,6 +1295,9 @@ td.code{font-family:'JetBrains Mono',monospace;color:var(--text);font-weight:600
     </div>
   </div>
 
+  ${moduleRows ? '<div class="panel" style="margin-bottom:20px"><div class="panel-title">MODULE BREAKDOWN · 模块统计</div>' +
+        '<table><thead><tr><th>所属模块</th><th>总任务</th><th>完成</th><th>完成率</th><th>进度</th></tr></thead><tbody>' + moduleRows + '</tbody></table></div>' : ''}
+
   ${hasAssignees ? '<div class="panel" style="margin-bottom:20px"><div class="panel-title">TEAM DETAILS</div>' +
         // ── 按平台分组的汇总表 ──
         (() => {
@@ -1386,7 +1510,7 @@ async function showHealthReport(config, iteration) {
         logger_1.logger.info("无活跃迭代");
         return;
     }
-    const iterDir = `Iteration-${iteration}`;
+    const iterDir = resolveIterDir(iteration);
     const tasks = await scanTaskDirs(iterDir);
     let totalTasks = tasks.length, completed = 0, hasTest = 0, hasReview = 0;
     for (const t of tasks) {
@@ -1416,14 +1540,15 @@ async function showLifecycleBoard(config, iteration, opts) {
         logger_1.logger.info("无活跃迭代");
         return;
     }
-    const iterDir = `Iteration-${iteration}`;
-    const tasks = await scanTaskDirs(iterDir);
-    logger_1.logger.info('\\n📋 任务生命周期 — ' + iteration);
-    const states = { pending: '🔲', in_progress: '🔵', testing: '🟡', review: '🟣', done: '🟢' };
-    for (const t of tasks) {
-        const status = await getTaskStatus(iterDir, t);
-        const icon = states[status] || '⚪';
-        logger_1.logger.info('  ' + icon + ' ' + t + '  [' + status + ']');
+    const iterDir = resolveIterDir(iteration);
+    // v8.3.293+: 改用 collectTasks 多根扫描（含 030-tasks/{type}/ 布局与 .meta/status），
+    // 修复此前只扫迭代根级 Task- 目录、读旧 .task-status 文件导致 bugfix 等任务在看板隐形
+    const taskList = await collectTasks(iterDir);
+    logger_1.logger.info('\n📋 任务生命周期 — ' + iteration);
+    for (const t of taskList) {
+        const status = t.status || 'pending';
+        const icon = statusIconFor(status);
+        logger_1.logger.info('  ' + icon + ' ' + t.id + '  [' + status + ']');
     }
     logger_1.logger.info('');
     logger_1.logger.info('  🔲待开始 → 🔵开发中 → 🟡测试中 → 🟣审查中 → 🟢已完成');
@@ -1448,15 +1573,16 @@ async function getTaskStatus(iterDir, task) {
 }
 // ── Collect Health Data for export ──
 async function collectHealthData(iteration) {
-    const iterDir = (0, path_1.join)(process.cwd(), "迭代-" + iteration);
-    const tasks = await scanTaskDirs(iterDir);
-    let total = tasks.length, completed = 0, hasTest = 0, hasReview = 0;
-    for (const t of tasks) {
-        if (await isTaskDone(iterDir, t))
+    const iterDir = (0, path_1.join)(process.cwd(), resolveIterDir(iteration));
+    // v8.3.293+: 多根扫描（含 030-tasks/{type}/），修复旧 scanTaskDirs 只扫根级导致漏计
+    const taskList = await collectTasks(iterDir);
+    let total = taskList.length, completed = 0, hasTest = 0, hasReview = 0;
+    for (const t of taskList) {
+        if (/完成|completed|done/i.test(t.status || ''))
             completed++;
-        if (await taskHasFile(iterDir, t, 'TEST.md'))
+        if (await taskHasFile(iterDir, t.id, 'TEST.md'))
             hasTest++;
-        if (await taskHasFile(iterDir, t, 'REVIEW.md'))
+        if (await taskHasFile(iterDir, t.id, 'REVIEW.md'))
             hasReview++;
     }
     const donePct = total > 0 ? Math.round(completed / total * 100) : 0;
@@ -1468,12 +1594,12 @@ async function collectHealthData(iteration) {
 }
 // ── Collect Lifecycle Data for export ──
 async function collectLifecycleData(iteration) {
-    const iterDir = (0, path_1.join)(process.cwd(), "迭代-" + iteration);
-    const taskDirs = await scanTaskDirs(iterDir);
+    const iterDir = (0, path_1.join)(process.cwd(), resolveIterDir(iteration));
+    // v8.3.293+: 多根扫描（含 030-tasks/{type}/），修复旧 scanTaskDirs 只扫根级导致漏计
+    const taskList = await collectTasks(iterDir);
     const tasks = [];
-    for (const t of taskDirs) {
-        const status = await getTaskStatus(iterDir, t);
-        tasks.push({ id: t, status });
+    for (const t of taskList) {
+        tasks.push({ id: t.id, status: t.status || 'pending' });
     }
     return { tasks, iteration };
 }