speccore 5.4.3 → 5.5.0

package/dist/commands/change.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * change - 需求变更联动命令
+ * 修改任务需求时，自动更新关联 Spec 文件
+ */
+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.changeCommand = changeCommand;
+const logger_1 = require("../utils/logger");
+const context_1 = require("../core/context");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const transaction_1 = require("../core/transaction");
+async function changeCommand(options) {
+    if (!options.task && !options.global) {
+        logger_1.logger.error('请指定要变更的 Task 或使用 --global。用法: speccore change --task=<Task编号> --desc="<变更描述>"');
+        return;
+    }
+    if (!options.desc) {
+        logger_1.logger.error('请提供变更描述。用法: speccore change --desc="<变更描述>"');
+        return;
+    }
+    const spinner = new logger_1.Spinner('正在分析变更影响...');
+    spinner.start();
+    try {
+        const iteration = await (0, context_1.getDefaultIteration)(options.iteration);
+        if (!iteration && !options.global) {
+            spinner.fail('未找到活跃期次。请先运行: speccore iteration create --name <名称>');
+            return;
+        }
+        if (options.dryRun) {
+            await dryRunChange(options, iteration);
+            spinner.stop('变更预览完成（--dry-run 模式，未实际修改）');
+            return;
+        }
+        if (options.global) {
+            await applyGlobalChange(options);
+        }
+        else {
+            await applyTaskChange(options, iteration);
+        }
+        spinner.stop('需求变更已生效');
+        logger_1.logger.info('');
+        logger_1.logger.info('下一步:');
+        logger_1.logger.info('  1. 运行 speccore validate --task=' + (options.task || '') + ' 验证完整性');
+        logger_1.logger.info('  2. 检查受影响的下游任务是否需要回归');
+    }
+    catch (error) {
+        spinner.fail(`变更失败: ${error}`);
+        throw error;
+    }
+}
+async function dryRunChange(options, iteration) {
+    if (options.global) {
+        logger_1.logger.info('🔍 全局层变更影响分析：');
+        logger_1.logger.info('');
+        logger_1.logger.info('| 文件 | 影响描述 |');
+        logger_1.logger.info('| :--- | :--- |');
+        logger_1.logger.info('| .speccore/CONSTITUTION.md | 全局配置变更 |');
+        logger_1.logger.info('| 所有期次的 TECH.md | 架构方案需同步 |');
+        logger_1.logger.info('');
+        return;
+    }
+    logger_1.logger.info(`🔍 ${options.task} 变更影响分析：`);
+    logger_1.logger.info('');
+    logger_1.logger.info(`变更描述: ${options.desc}`);
+    if (iteration) {
+        const taskDir = (0, path_1.join)(process.cwd(), iteration, options.task || '');
+        logger_1.logger.info('| 文件 | 影响描述 |');
+        logger_1.logger.info('| :--- | :--- |');
+        logger_1.logger.info(`| ${options.task}/backend/REQ.md | 需求变更 |`);
+        logger_1.logger.info(`| ${options.task}/backend/TECH.md | 方案需调整 |`);
+        logger_1.logger.info(`| ${options.task}/_shared/API_CONTRACT.yaml | 接口契约可能需更新 |`);
+        // 查找受影响的依赖任务
+        if (await (0, fs_extra_1.pathExists)(taskDir)) {
+            const graphPath = (0, path_1.join)(process.cwd(), iteration, '00-期次总览', 'PROJECT_GRAPH.md');
+            if (await (0, fs_extra_1.pathExists)(graphPath)) {
+                const content = await (0, fs_extra_1.readFile)(graphPath, 'utf-8');
+                const deps = findDependentTasks(content, options.task || '');
+                if (deps.length > 0) {
+                    logger_1.logger.info('');
+                    logger_1.logger.warn('🔗 受影响下游任务：');
+                    for (const dep of deps) {
+                        logger_1.logger.info(`   ${dep} → 🔶 待回归`);
+                    }
+                }
+            }
+        }
+    }
+}
+async function applyTaskChange(options, iteration) {
+    if (!options.task) {
+        logger_1.logger.error('请指定 --task');
+        return;
+    }
+    const taskDir = (0, path_1.join)(process.cwd(), iteration, options.task);
+    if (!await (0, fs_extra_1.pathExists)(taskDir)) {
+        logger_1.logger.error(`任务目录不存在: ${taskDir}`);
+        return;
+    }
+    const tx = new transaction_1.FileTransaction();
+    const now = new Date().toISOString().split('T')[0];
+    // 更新 REQ.md（事务保护）
+    const reqPath = (0, path_1.join)(taskDir, 'backend', 'REQ.md');
+    if (await (0, fs_extra_1.pathExists)(reqPath)) {
+        let content = await (0, fs_extra_1.readFile)(reqPath, 'utf-8');
+        const changeNote = `\n## 变更记录\n\n| ${now} | v1.1 | ${options.desc} | SpecCore |\n`;
+        tx.write(reqPath, content + changeNote);
+    }
+    // 更新 TASK.md 变更履历（事务保护）
+    const taskMdPath = (0, path_1.join)(taskDir, 'backend', 'TASK.md');
+    if (await (0, fs_extra_1.pathExists)(taskMdPath)) {
+        let content = await (0, fs_extra_1.readFile)(taskMdPath, 'utf-8');
+        const changeEntry = `| ${now} | v1.1 | 需求变更: ${options.desc} | SpecCore |\n`;
+        const updated = content.replace(/(\| :--- \| :--- \| :--- \| :--- \|)/, `$1\n${changeEntry}`);
+        tx.write(taskMdPath, updated);
+    }
+    // 同步前端各平台 TASK.md（事务保护）
+    const frontendDir = (0, path_1.join)(taskDir, 'frontend');
+    if (await (0, fs_extra_1.pathExists)(frontendDir)) {
+        const { readdir: rd } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
+        const platformDirs = await rd(frontendDir, { withFileTypes: true });
+        for (const pd of platformDirs) {
+            if (pd.isDirectory()) {
+                const ftaskPath = (0, path_1.join)(frontendDir, pd.name, 'TASK.md');
+                if (await (0, fs_extra_1.pathExists)(ftaskPath)) {
+                    let content = await (0, fs_extra_1.readFile)(ftaskPath, 'utf-8');
+                    const changeEntry = `| ${now} | v1.1 | 需求变更: ${options.desc} | SpecCore |\n`;
+                    const updated = content.replace(/(\| :--- \| :--- \| :--- \| :--- \|)/, `$1\n${changeEntry}`);
+                    tx.write(ftaskPath, updated);
+                }
+            }
+        }
+    }
+    // 提交事务 — 原子写入，失败回滚
+    if (tx.length > 0) {
+        await tx.commit();
+        logger_1.logger.info(`✅ 已更新 ${tx.length} 个文件（事务保护）`);
+        logger_1.logger.info(`   ${options.task}/backend/REQ.md`);
+        logger_1.logger.info(`   ${options.task}/backend/TASK.md`);
+    }
+}
+async function applyGlobalChange(options) {
+    const tx = new transaction_1.FileTransaction();
+    // 更新 CONSTITUTION.md 的变更记录（事务保护）
+    const constPath = (0, path_1.join)(process.cwd(), '.speccore', 'CONSTITUTION.md');
+    if (await (0, fs_extra_1.pathExists)(constPath)) {
+        let content = await (0, fs_extra_1.readFile)(constPath, 'utf-8');
+        const now = new Date().toISOString().split('T')[0];
+        content += `\n## 变更记录\n\n| ${now} | ${options.desc} | SpecCore |\n`;
+        tx.write(constPath, content);
+    }
+    if (tx.length > 0) {
+        await tx.commit();
+        logger_1.logger.info('✅ 已更新: .speccore/CONSTITUTION.md（事务保护）');
+    }
+}
+function findDependentTasks(graphContent, taskName) {
+    const deps = [];
+    const lines = graphContent.split('\n');
+    for (const line of lines) {
+        // 查找依赖关系：Task 行中包含对目标 Task 的引用
+        if (line.includes(taskName) && !line.includes(`| ${taskName} |`)) {
+            const match = line.match(/Task-\d+/g);
+            if (match) {
+                for (const t of match) {
+                    if (t !== taskName && !deps.includes(t)) {
+                        deps.push(t);
+                    }
+                }
+            }
+        }
+    }
+    return deps;
+}
+//# sourceMappingURL=change.js.map

package/dist/commands/change.js.map

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

package/dist/commands/context.d.ts

@@ -0,0 +1,8 @@
+/**
+ * context — 查看当前 Task 的上下文加载状态和 Spec 依赖链
+ */
+export interface ContextOptions {
+    task?: string;
+}
+export declare function contextCommand(options: ContextOptions): Promise<void>;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqE3E"}

package/dist/commands/context.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * context — 查看当前 Task 的上下文加载状态和 Spec 依赖链
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextCommand = contextCommand;
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const logger_1 = require("../utils/logger");
+const context_1 = require("../core/context");
+async function contextCommand(options) {
+    try {
+        const ctx = await (0, context_1.loadContext)();
+        const taskName = options.task || ctx.currentTask;
+        if (!taskName) {
+            logger_1.logger.info('📋 SpecCore 上下文信息');
+            logger_1.logger.info('');
+            logger_1.logger.info('当前状态：');
+            logger_1.logger.info(`  当前期次：${ctx.currentIteration || '无'}`);
+            logger_1.logger.info(`  当前任务：${ctx.currentTask || '无'}`);
+            logger_1.logger.info(`  执行人：${ctx.currentAssignee || '无'}`);
+            logger_1.logger.info(`  期次状态：${ctx.iterationStatus || '无'}`);
+            logger_1.logger.info(`  待处理：${ctx.pendingTasks}  进行中：${ctx.inProgressTasks}  已完成：${ctx.completedTasks}  阻塞：${ctx.blockedTasks}`);
+            logger_1.logger.info('');
+            logger_1.logger.info(`  最后操作：${ctx.lastAction || '无'}`);
+            logger_1.logger.info(`  最后意图：${ctx.lastIntent || '无'}`);
+            logger_1.logger.info(`  最后更新：${ctx.lastUpdated || '无'}`);
+            return;
+        }
+        // 查找 Task 目录
+        const taskDir = await findTaskDir(taskName);
+        if (!taskDir) {
+            logger_1.logger.error(`Task not found: ${taskName}`);
+            return;
+        }
+        // 分析上下文
+        const analysis = await analyzeTaskContext(taskDir);
+        logger_1.logger.info('📋 Task 上下文分析');
+        logger_1.logger.info('');
+        logger_1.logger.info(`📂 Task: ${taskName}`);
+        logger_1.logger.info(`📍 路径: ${taskDir}`);
+        logger_1.logger.info('');
+        // Spec 文件状态
+        logger_1.logger.info('📄 Spec 文件加载状态：');
+        for (const file of analysis.specFiles) {
+            const icon = file.exists ? '✅' : '❌';
+            logger_1.logger.info(`  ${icon} ${file.name} [${file.type}] ${file.size ? `(${file.size})` : ''}`);
+        }
+        // 平台
+        if (analysis.platforms.length > 0) {
+            logger_1.logger.info('');
+            logger_1.logger.info('📱 平台覆盖：');
+            for (const platform of analysis.platforms) {
+                logger_1.logger.info(`  - ${platform}`);
+            }
+        }
+        // 依赖分析
+        if (analysis.dependencies.length > 0) {
+            logger_1.logger.info('');
+            logger_1.logger.info('🔗 跨平台依赖：');
+            for (const dep of analysis.dependencies) {
+                logger_1.logger.info(`  - ${dep}`);
+            }
+        }
+        // 验收标准
+        logger_1.logger.info('');
+        logger_1.logger.info('📊 验收标准：');
+        logger_1.logger.info(`  总计: ${analysis.totalAC}  通过: ${analysis.passedAC}  未通过: ${analysis.failedAC}`);
+    }
+    catch (error) {
+        logger_1.logger.error(`Context analysis failed: ${error}`);
+    }
+}
+/**
+ * 查找 Task 目录
+ */
+async function findTaskDir(taskName) {
+    const cwd = process.cwd();
+    const entries = await (0, fs_extra_1.readdir)(cwd, { withFileTypes: true });
+    // 直接匹配
+    const directPaths = [
+        (0, path_1.join)(cwd, taskName),
+        (0, path_1.join)(cwd, `期次-*/*${taskName}*`),
+    ];
+    const exactMatch = (0, path_1.join)(cwd, taskName);
+    if (await (0, fs_extra_1.pathExists)(exactMatch))
+        return exactMatch;
+    // 遍历期次目录查找
+    for (const entry of entries) {
+        if (entry.isDirectory() && entry.name.startsWith('期次-')) {
+            const iterPath = (0, path_1.join)(cwd, entry.name);
+            const tasks = await (0, fs_extra_1.readdir)(iterPath, { withFileTypes: true });
+            for (const task of tasks) {
+                if (task.isDirectory() && (task.name === taskName ||
+                    task.name.startsWith(taskName) ||
+                    task.name.includes(taskName))) {
+                    return (0, path_1.join)(iterPath, task.name);
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 分析 Task 上下文
+ */
+async function analyzeTaskContext(taskDir) {
+    const result = {
+        specFiles: [],
+        platforms: [],
+        dependencies: [],
+        totalAC: 0,
+        passedAC: 0,
+        failedAC: 0,
+    };
+    // 检查 _shared/
+    const shared = (0, path_1.join)(taskDir, '_shared');
+    if (await (0, fs_extra_1.pathExists)(shared)) {
+        const sharedFiles = await (0, fs_extra_1.readdir)(shared);
+        for (const file of sharedFiles) {
+            const filePath = (0, path_1.join)(shared, file);
+            const stats = await (0, fs_extra_1.readFile)(filePath, 'utf-8').then(s => s.length).catch(() => 0);
+            result.specFiles.push({ name: file, type: '共享', exists: true, size: formatSize(stats) });
+        }
+    }
+    // 检查 backend/
+    const backend = (0, path_1.join)(taskDir, 'backend');
+    if (await (0, fs_extra_1.pathExists)(backend)) {
+        const files = await (0, fs_extra_1.readdir)(backend);
+        for (const file of files) {
+            const filePath = (0, path_1.join)(backend, file);
+            const stats = await (0, fs_extra_1.readFile)(filePath, 'utf-8').then(s => s.length).catch(() => 0);
+            result.specFiles.push({ name: file, type: '后端', exists: true, size: formatSize(stats) });
+            // 统计验收标准
+            if (file === 'REQ.md') {
+                const content = await (0, fs_extra_1.readFile)(filePath, 'utf-8').catch(() => '');
+                result.totalAC += (content.match(/- \[[ x]\] AC-/g) || []).length;
+                result.passedAC += (content.match(/- \[x\] AC-/g) || []).length;
+                result.failedAC = result.totalAC - result.passedAC;
+            }
+        }
+    }
+    else {
+        result.specFiles.push({ name: 'backend/', type: '后端', exists: false, size: '-' });
+    }
+    // 检查 frontend/{platform}/
+    const frontend = (0, path_1.join)(taskDir, 'frontend');
+    if (await (0, fs_extra_1.pathExists)(frontend)) {
+        const platformDirs = await (0, fs_extra_1.readdir)(frontend, { withFileTypes: true });
+        for (const pd of platformDirs) {
+            if (pd.isDirectory()) {
+                result.platforms.push(pd.name);
+                const pDir = (0, path_1.join)(frontend, pd.name);
+                const files = await (0, fs_extra_1.readdir)(pDir);
+                for (const file of files) {
+                    const filePath = (0, path_1.join)(pDir, file);
+                    const stats = await (0, fs_extra_1.readFile)(filePath, 'utf-8').then(s => s.length).catch(() => 0);
+                    result.specFiles.push({ name: file, type: `前端/${pd.name}`, exists: true, size: formatSize(stats) });
+                }
+            }
+        }
+    }
+    // 检查跨平台依赖
+    if (result.platforms.length > 0) {
+        for (let i = 0; i < result.platforms.length; i++) {
+            for (let j = i + 1; j < result.platforms.length; j++) {
+                result.dependencies.push(`${result.platforms[i]} ↔ ${result.platforms[j]} (共享 API_CONTRACT.yaml)`);
+            }
+        }
+    }
+    return result;
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAWH,wCAqEC;AA9ED,uCAAyD;AACzD,+BAA4B;AAC5B,4CAAyC;AACzC,6CAA8C;AAMvC,KAAK,UAAU,cAAc,CAAC,OAAuB;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAW,GAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,WAAW,CAAC;QAEjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,eAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACjC,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,eAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,eAAM,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,gBAAgB,IAAI,GAAG,EAAE,CAAC,CAAC;YACrD,eAAM,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,WAAW,IAAI,GAAG,EAAE,CAAC,CAAC;YAChD,eAAM,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,eAAe,IAAI,GAAG,EAAE,CAAC,CAAC;YACnD,eAAM,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,eAAe,IAAI,GAAG,EAAE,CAAC,CAAC;YACpD,eAAM,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,YAAY,SAAS,GAAG,CAAC,eAAe,SAAS,GAAG,CAAC,cAAc,QAAQ,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;YACxH,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,eAAM,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC;YAC/C,eAAM,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC;YAC/C,eAAM,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,WAAW,IAAI,GAAG,EAAE,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,aAAa;QACb,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,eAAM,CAAC,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,QAAQ;QACR,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAEnD,eAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7B,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,eAAM,CAAC,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;QACpC,eAAM,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACjC,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEhB,YAAY;QACZ,eAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACrC,eAAM,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,KAAK;QACL,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,eAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxB,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC1C,eAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,OAAO;QACP,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,eAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACzB,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;gBACxC,eAAM,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO;QACP,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,eAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,eAAM,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,OAAO,SAAS,QAAQ,CAAC,QAAQ,UAAU,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,OAAO;IACP,MAAM,WAAW,GAAG;QAClB,IAAA,WAAI,EAAC,GAAG,EAAE,QAAQ,CAAC;QACnB,IAAA,WAAI,EAAC,GAAG,EAAE,SAAS,QAAQ,GAAG,CAAC;KAChC,CAAC;IAEF,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACvC,IAAI,MAAM,IAAA,qBAAU,EAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAEpD,WAAW;IACX,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,MAAM,IAAA,kBAAO,EAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,CACxB,IAAI,CAAC,IAAI,KAAK,QAAQ;oBACtB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAC7B,EAAE,CAAC;oBACF,OAAO,IAAA,WAAI,EAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,kBAAkB,CAAC,OAAe;IAQ/C,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,EAAqE;QAChF,SAAS,EAAE,EAAc;QACzB,YAAY,EAAE,EAAc;QAC5B,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;KACZ,CAAC;IAEF,cAAc;IACd,MAAM,MAAM,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxC,IAAI,MAAM,IAAA,qBAAU,EAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,MAAM,IAAA,kBAAO,EAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACpC,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YACnF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzC,IAAI,MAAM,IAAA,qBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,IAAA,kBAAO,EAAC,OAAO,CAAC,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YACnF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAEzF,SAAS;YACT,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAClE,MAAM,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAClE,MAAM,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAChE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC;YACrD,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC3C,IAAI,MAAM,IAAA,qBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,MAAM,IAAA,kBAAO,EAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC/B,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,KAAK,GAAG,MAAM,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;gBAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAClC,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;oBACnF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACtG,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU;IACV,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrD,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;YACrG,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,GAAG,CAAC;IACrC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC"}

package/dist/commands/dashboard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * dashboard - 生成可视化仪表盘命令
+ * 基于全量层数据生成静态 HTML 仪表盘，含 Chart.js 图表
+ */
+export interface DashboardOptions {
+    output?: string;
+}
+export declare function dashboardCommand(options: DashboardOptions): Promise<void>;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/commands/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/commands/dashboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4D/E"}

package/dist/commands/dashboard.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * dashboard - 生成可视化仪表盘命令
+ * 基于全量层数据生成静态 HTML 仪表盘，含 Chart.js 图表
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dashboardCommand = dashboardCommand;
+const logger_1 = require("../utils/logger");
+const global_layer_1 = require("../core/global-layer");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+async function dashboardCommand(options) {
+    const spinner = new logger_1.Spinner('采集全量层数据...');
+    spinner.start();
+    try {
+        const index = await (0, global_layer_1.readGlobalIndex)();
+        if (index.projects.length === 0 && index.reqs.length === 0) {
+            spinner.fail('全量层为空，无法生成仪表盘。请先导入项目。');
+            return;
+        }
+        spinner.stop('数据采集完成，正在生成仪表盘...');
+        // 统计数据
+        const totalReqs = index.reqs.length;
+        const implemented = index.reqs.filter((r) => r.status === '✅ 已实现' || r.status === '📦 已有实现').length;
+        const inProgress = index.reqs.filter((r) => r.status === '🔄 进行中').length;
+        const pending = totalReqs - implemented - inProgress;
+        const completionRate = totalReqs > 0 ? Math.round((implemented / totalReqs) * 100) : 0;
+        // 项目分布数据
+        const projectLabels = index.projects.map((p) => p.name);
+        const projectReqs = index.projects.map((p) => p.reqCount);
+        // 生成 HTML
+        const html = generateDashboardHtml(index.projects.length, totalReqs, implemented, inProgress, pending, completionRate, projectLabels, projectReqs, index);
+        const outputPath = options.output || (0, path_1.join)(process.cwd(), 'speccore-dashboard.html');
+        await (0, fs_extra_1.writeFile)(outputPath, html);
+        logger_1.logger.info('');
+        logger_1.logger.success('✅ 仪表盘已生成！');
+        logger_1.logger.info('');
+        logger_1.logger.info(`📁 输出文件: ${outputPath}`);
+        logger_1.logger.info('');
+        logger_1.logger.info('📊 包含内容:');
+        logger_1.logger.info('   - 统计卡片：总需求、已实现、进行中、待开发');
+        logger_1.logger.info('   - 需求状态分布（饼图）');
+        logger_1.logger.info('   - 项目需求分布（柱状图）');
+        logger_1.logger.info('   - 项目详细列表');
+        logger_1.logger.info('   - 期次关联状态');
+        logger_1.logger.info('');
+        logger_1.logger.info('💡 在浏览器中打开即可查看。支持移动端自适应布局。');
+    }
+    catch (error) {
+        spinner.fail(`生成仪表盘失败: ${error}`);
+        throw error;
+    }
+}
+function generateDashboardHtml(projectCount, totalReqs, implemented, inProgress, pending, completionRate, projectLabels, projectReqs, index) {
+    const now = new Date().toISOString().split('T')[0];
+    // 生成项目表格行
+    let projectRows = '';
+    for (const proj of index.projects) {
+        projectRows += `<tr><td>${proj.name}</td><td><span class="badge badge-${proj.type}">${proj.type}</span></td><td>${proj.reqCount}</td><td>${proj.lastImport}</td></tr>`;
+    }
+    // 生成需求表格行
+    let reqRows = '';
+    for (const req of index.reqs.slice(0, 20)) {
+        const statusClass = req.status.includes('✅') ? 'done' : req.status.includes('🔄') ? 'progress' : 'pending';
+        reqRows += `<tr><td>${req.id}</td><td>${req.name}</td><td>${req.project}</td><td><span class="badge badge-${statusClass}">${req.status}</span></td><td>${req.iteration || '-'}</td></tr>`;
+    }
+    return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>SpecCore 项目仪表盘</title>
+<script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.min.js"></script>
+<style>
+* { margin: 0; padding: 0; box-sizing: border-box; }
+body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'PingFang SC', sans-serif; background: #f0f2f5; padding: 24px; color: #1a1a2e; }
+.container { max-width: 1400px; margin: 0 auto; }
+.header { background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%); color: white; padding: 28px 32px; border-radius: 16px; margin-bottom: 24px; }
+.header h1 { font-size: 26px; font-weight: 700; letter-spacing: -0.5px; }
+.header .meta { opacity: 0.6; margin-top: 6px; font-size: 14px; }
+.stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 16px; margin-bottom: 24px; }
+.stat-card { background: white; border-radius: 12px; padding: 24px; box-shadow: 0 1px 3px rgba(0,0,0,0.06); text-align: center; }
+.stat-card .label { font-size: 13px; color: #64748b; margin-bottom: 8px; font-weight: 500; }
+.stat-card .value { font-size: 36px; font-weight: 800; letter-spacing: -1px; }
+.stat-card .sub { font-size: 13px; color: #94a3b8; margin-top: 4px; }
+.stat-card .value.green { color: #22c55e; }
+.stat-card .value.blue { color: #3b82f6; }
+.stat-card .value.amber { color: #f59e0b; }
+.stat-card .value.gray { color: #64748b; }
+.charts { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; margin-bottom: 24px; }
+@media (max-width: 768px) { .charts { grid-template-columns: 1fr; } .stats { grid-template-columns: 1fr 1fr; } }
+.chart-card { background: white; border-radius: 12px; padding: 24px; box-shadow: 0 1px 3px rgba(0,0,0,0.06); }
+.chart-card h3 { font-size: 16px; font-weight: 600; margin-bottom: 16px; color: #334155; }
+.chart-card canvas { max-height: 300px; }
+.full { grid-column: 1 / -1; }
+.table-card { background: white; border-radius: 12px; padding: 24px; box-shadow: 0 1px 3px rgba(0,0,0,0.06); margin-bottom: 24px; overflow-x: auto; }
+.table-card h3 { font-size: 16px; font-weight: 600; margin-bottom: 16px; color: #334155; }
+table { width: 100%; border-collapse: collapse; font-size: 14px; }
+thead tr { border-bottom: 2px solid #e2e8f0; }
+th { text-align: left; padding: 10px 8px; color: #64748b; font-weight: 600; font-size: 13px; }
+td { padding: 10px 8px; border-bottom: 1px solid #f1f5f9; }
+.badge { display: inline-block; padding: 3px 10px; border-radius: 20px; font-size: 12px; font-weight: 500; }
+.badge-backend { background: #dbeafe; color: #1e40af; }
+.badge-web { background: #dcfce7; color: #166534; }
+.badge-h5 { background: #fef3c7; color: #92400e; }
+.badge-miniapp { background: #f3e8ff; color: #6b21a8; }
+.badge-done { background: #dcfce7; color: #166534; }
+.badge-progress { background: #dbeafe; color: #1e40af; }
+.badge-pending { background: #f1f5f9; color: #64748b; }
+.footer { text-align: center; color: #94a3b8; font-size: 12px; margin-top: 32px; padding: 16px; }
+</style>
+</head>
+<body>
+<div class="container">
+<div class="header">
+  <h1>📊 SpecCore 项目仪表盘</h1>
+  <div class="meta">生成时间: ${now} | 全量层版本: ${index.version} | 项目数: ${projectCount}</div>
+</div>
+
+<div class="stats">
+  <div class="stat-card">
+    <div class="label">📋 总需求数</div>
+    <div class="value blue">${totalReqs}</div>
+    <div class="sub">${projectCount} 个项目</div>
+  </div>
+  <div class="stat-card">
+    <div class="label">✅ 已完成</div>
+    <div class="value green">${implemented}</div>
+    <div class="sub">完成率 ${completionRate}%</div>
+  </div>
+  <div class="stat-card">
+    <div class="label">🔄 进行中</div>
+    <div class="value amber">${inProgress}</div>
+    <div class="sub">${Math.round((inProgress / (totalReqs || 1)) * 100)}%</div>
+  </div>
+  <div class="stat-card">
+    <div class="label">🔲 待开发</div>
+    <div class="value gray">${pending}</div>
+    <div class="sub">${Math.round((pending / (totalReqs || 1)) * 100)}%</div>
+  </div>
+</div>
+
+<div class="charts">
+  <div class="chart-card">
+    <h3>📊 需求状态分布</h3>
+    <canvas id="statusChart"></canvas>
+  </div>
+  <div class="chart-card">
+    <h3>📈 项目需求分布</h3>
+    <canvas id="projectChart"></canvas>
+  </div>
+</div>
+
+<div class="table-card">
+  <h3>📋 项目列表</h3>
+  <table>
+    <thead><tr><th>项目名称</th><th>类型</th><th>需求数</th><th>最后导入</th></tr></thead>
+    <tbody>${projectRows || '<tr><td colspan="4">暂无项目</td></tr>'}</tbody>
+  </table>
+</div>
+
+<div class="table-card">
+  <h3>📝 需求详情</h3>
+  <table>
+    <thead><tr><th>需求 ID</th><th>名称</th><th>项目</th><th>状态</th><th>关联期次</th></tr></thead>
+    <tbody>${reqRows || '<tr><td colspan="5">暂无需求</td></tr>'}</tbody>
+  </table>
+</div>
+
+<div class="footer">Powered by SpecCore | Generated ${now}</div>
+</div>
+
+<script>
+new Chart(document.getElementById('statusChart'), {
+  type: 'doughnut',
+  data: {
+    labels: ['已实现', '进行中', '待开发'],
+    datasets: [{
+      data: [${implemented}, ${inProgress}, ${pending}],
+      backgroundColor: ['#22c55e', '#3b82f6', '#e2e8f0'],
+      borderWidth: 2,
+      borderColor: '#fff'
+    }]
+  },
+  options: { responsive: true, plugins: { legend: { position: 'bottom' } } }
+});
+
+new Chart(document.getElementById('projectChart'), {
+  type: 'bar',
+  data: {
+    labels: ${JSON.stringify(projectLabels)},
+    datasets: [{
+      label: '需求数',
+      data: ${JSON.stringify(projectReqs)},
+      backgroundColor: '#3b82f6',
+      borderRadius: 8
+    }]
+  },
+  options: {
+    responsive: true,
+    plugins: { legend: { display: false } },
+    scales: { y: { beginAtZero: true, ticks: { stepSize: 1 } } }
+  }
+});
+</script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=dashboard.js.map