speccore 5.3.2 → 5.3.3

package/dist/commands/bugfix.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * bugfix - 快速 Bug 修复命令
+ * 创建修复任务，自动标注受影响文件和回归范围
+ */
+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.bugfixCommand = bugfixCommand;
+const logger_1 = require("../utils/logger");
+const context_1 = require("../core/context");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+async function bugfixCommand(options) {
+    if (!options.name && !options.desc) {
+        logger_1.logger.error('请提供 Bug 描述。用法: speccore bugfix --name "<Bug名称>" [--desc "<详细描述>"]');
+        return;
+    }
+    const spinner = new logger_1.Spinner('正在创建 Bug 修复任务...');
+    spinner.start();
+    try {
+        const iteration = await (0, context_1.getDefaultIteration)(options.iteration);
+        if (!iteration) {
+            spinner.fail('未找到活跃期次。请先运行: speccore iteration create --name <名称>');
+            return;
+        }
+        const bugName = options.name || 'Bug修复';
+        const taskId = options.taskId || await generateTaskId(iteration);
+        // 创建修复任务目录
+        const taskDir = (0, path_1.join)(iteration, taskId);
+        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'backend'));
+        // 创建 .task-type
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.task-type'), 'bugfix');
+        // 生成修复 Spec
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'REQ.md'), generateBugfixReq(bugName, options.desc || '', options.affectedTask));
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'TASK.md'), generateBugfixTask(bugName, options.desc || '', options.affectedTask));
+        spinner.stop(`Bug 修复任务已创建: ${taskId}`);
+        logger_1.logger.info('');
+        logger_1.logger.info(`🐛 Bug 修复详情:`);
+        logger_1.logger.info(`   期次: ${iteration}`);
+        logger_1.logger.info(`   任务: ${taskId} - ${bugName}`);
+        if (options.affectedTask) {
+            logger_1.logger.info(`   ⚠️ 受影响任务: ${options.affectedTask}`);
+        }
+        if (options.desc) {
+            logger_1.logger.info(`   描述: ${options.desc}`);
+        }
+        logger_1.logger.info('');
+        logger_1.logger.info('下一步:');
+        logger_1.logger.info(`  1. 编辑 ${taskId}/backend/REQ.md 补充根因分析`);
+        logger_1.logger.info('  2. 运行: speccore execute --task=' + taskId);
+    }
+    catch (error) {
+        spinner.fail(`Bug 修复任务创建失败: ${error}`);
+        throw error;
+    }
+}
+async function generateTaskId(iteration) {
+    let maxId = 0;
+    const iterationDir = (0, path_1.join)(process.cwd(), iteration);
+    if (await (0, fs_extra_1.pathExists)(iterationDir)) {
+        const { readdir } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
+        const entries = await readdir(iterationDir);
+        for (const entry of entries) {
+            const match = entry.match(/^Task-(\d+)$/);
+            if (match) {
+                const id = parseInt(match[1], 10);
+                if (id > maxId)
+                    maxId = id;
+            }
+        }
+    }
+    return `Task-${String(maxId + 1).padStart(3, '0')}`;
+}
+function generateBugfixReq(name, desc, affectedTask) {
+    return `# ${name} - Bug 修复需求
+
+## 1. 问题描述
+
+${desc || '请补充问题描述'}
+
+## 2. 复现步骤
+
+1. 
+2. 
+3. 
+
+## 3. 预期行为
+
+- 
+
+## 4. 实际行为
+
+- 
+
+${affectedTask ? `
+## 5. 受影响任务
+
+- ${affectedTask} → 🔶 待回归
+` : ''}
+
+## 6. 根因分析
+
+- 
+
+## 7. 修复方案
+
+- 
+
+## 8. 验收标准
+
+- [ ] Bug 不再复现
+- [ ] 回归测试通过
+- [ ] 相关 Spec 文件已同步更新
+`;
+}
+function generateBugfixTask(name, desc, affectedTask) {
+    const now = new Date().toISOString().split('T')[0];
+    return `# ${name} - 执行追踪
+
+> **任务类型**: bugfix | **创建日期**: ${now} | **状态**: 🔲 待开发
+
+## 1. 变更履历
+
+| 日期 | 版本 | 变更说明 | 作者 |
+| :--- | :--- | :--- | :--- |
+| ${now} | v1.0 | 初始创建：${desc} | SpecCore |
+
+## 2. 修复步骤
+
+- [ ] 根因定位
+- [ ] 编写修复代码
+- [ ] 单元测试
+- [ ] 回归测试${affectedTask ? ` (含 ${affectedTask})` : ''}
+- [ ] Spec 同步更新
+
+## 3. 影响范围
+
+| 受影响文件 | 影响描述 | 状态 |
+| :--- | :--- | :--- |
+| | | |
+
+## 4. 线上问题记录
+
+| 日期 | 问题描述 | 根因 | 修复方案 | 状态 |
+| :--- | :--- | :--- | :--- | :--- |
+| ${now} | ${desc} | 待分析 | 待制定 | 🔲 |
+`;
+}
+//# sourceMappingURL=bugfix.js.map

package/dist/commands/bugfix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bugfix.js","sourceRoot":"","sources":["../../src/commands/bugfix.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBH,sCAuDC;AArED,4CAAkD;AAClD,6CAAsD;AACtD,uCAA4D;AAE5D,+BAA4B;AAUrB,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACnC,eAAM,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;QAClF,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,gBAAO,CAAC,kBAAkB,CAAC,CAAC;IAChD,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,IAAA,6BAAmB,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;QAEjE,WAAW;QACX,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,IAAA,oBAAS,EAAC,IAAA,WAAI,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAE1C,gBAAgB;QAChB,MAAM,IAAA,oBAAS,EAAC,IAAA,WAAI,EAAC,OAAO,EAAE,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;QAEvD,YAAY;QACZ,MAAM,IAAA,oBAAS,EACb,IAAA,WAAI,EAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,EAClC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,CACrE,CAAC;QACF,MAAM,IAAA,oBAAS,EACb,IAAA,WAAI,EAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,EACnC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,CACtE,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;QACvC,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,eAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5B,eAAM,CAAC,IAAI,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;QACnC,eAAM,CAAC,IAAI,CAAC,UAAU,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,eAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,eAAM,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,eAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,eAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,eAAM,CAAC,IAAI,CAAC,WAAW,MAAM,wBAAwB,CAAC,CAAC;QACvD,eAAM,CAAC,IAAI,CAAC,mCAAmC,GAAG,MAAM,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;QACvC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,SAAiB;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,MAAM,IAAA,qBAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QACnC,MAAM,EAAE,OAAO,EAAE,GAAG,wDAAa,UAAU,GAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAC1C,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,IAAI,EAAE,GAAG,KAAK;oBAAE,KAAK,GAAG,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,IAAY,EAAE,YAAqB;IAC1E,OAAO,KAAK,IAAI;;;;EAIhB,IAAI,IAAI,SAAS;;;;;;;;;;;;;;;;EAgBjB,YAAY,CAAC,CAAC,CAAC;;;IAGb,YAAY;CACf,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;CAeL,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,IAAY,EAAE,YAAqB;IAC3E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,OAAO,KAAK,IAAI;;iCAEe,GAAG;;;;;;IAMhC,GAAG,kBAAkB,IAAI;;;;;;;YAOjB,YAAY,CAAC,CAAC,CAAC,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;IAalD,GAAG,MAAM,IAAI;CAChB,CAAC;AACF,CAAC"}

package/dist/commands/change.d.ts

@@ -0,0 +1,14 @@
+/**
+ * change - 需求变更联动命令
+ * 修改任务需求时，自动更新关联 Spec 文件
+ */
+export interface ChangeOptions {
+    task?: string;
+    desc?: string;
+    global?: boolean;
+    iteration?: string;
+    dryRun?: boolean;
+    force?: boolean;
+}
+export declare function changeCommand(options: ChangeOptions): Promise<void>;
+//# sourceMappingURL=change.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../src/commands/change.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CzE"}

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":"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"}

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"}