speccore 8.3.276 → 8.3.278

package/dist/commands/iteration/taskify.js

@@ -640,8 +640,10 @@ async function iterationTaskifyCommand(options) {
         }
         const extracted = extractJsonArray(options.response);
         // 尝试解析 AI 返回的 JSON Task 列表
+        let jsonParsed = false;
         try {
             const tasks = JSON.parse(extracted.json);
+            jsonParsed = true;
             if (Array.isArray(tasks)) {
                 const allPlatforms = await detectPlatforms(iterDirFull);
                 const sections = [];
@@ -716,8 +718,12 @@ async function iterationTaskifyCommand(options) {
                         section.functionalUnit = task.functionalUnit;
                     if (task.reason)
                         section._reason = task.reason;
-                    if (taskScopePlatforms.length > 0)
+                    if (taskScopePlatforms.length > 0) {
                         section._scopePlatforms = taskScopePlatforms;
+                        // v8.3.277: 标记 AI 显式声明了 scope（用于区分「推断出的端」与「AI 明确意图」，
+                        // 显式 scope 不自动补后端，推断 scope 保留自动补后端）
+                        section._explicitScope = true;
+                    }
                     sections.push(section);
                 }
                 // v8.3.223+: 过滤骨架质量标准标题泄漏为功能单元名（spec-skeleton 注入的引导标题
@@ -980,8 +986,25 @@ async function iterationTaskifyCommand(options) {
                 }
                 // 逐任务交互确认
                 const createdSections = [];
+                const moduleFilter = (unit) => {
+                    if (scopeModules.length === 0)
+                        return true;
+                    const u = (unit || '').toLowerCase();
+                    return scopeModules.some((m) => {
+                        const mf = m.toLowerCase();
+                        return u === mf || u.includes(mf) || mf.includes(u);
+                    });
+                };
+                let filteredCount = 0;
                 for (let i = 0; i < sections.length; i++) {
                     const sec = sections[i];
+                    // v8.3.277: --modules 指定范围重建时，只创建匹配模块的任务，其余跳过（避免重复）
+                    const secUnit = sec.functionalUnit || sec.name || '';
+                    if (!moduleFilter(secUnit)) {
+                        filteredCount++;
+                        logger_1.logger.info(`   ⏭️  跳过「${sec.name}」（不属于 --modules 指定范围，已保留旧任务）`);
+                        continue;
+                    }
                     const complexity = sec._complexity || {};
                     const taskType = sec._taskType || 'feature';
                     const deps = (tasks[i].dependencies || []);
@@ -1032,7 +1055,7 @@ async function iterationTaskifyCommand(options) {
                     // 输出下一步操作标记：引导宿主 AI 填充任务级 00-specs/ 文档（analyze --task 已删除）
                     outputAnalyzeTaskHints(iter, createdSections);
                 }
-                logger_1.logger.success(`✅ 创建了 ${createdSections.length}/${sections.length} 个任务（${sections.length - createdSections.length} 个跳过）`);
+                logger_1.logger.success(`✅ 创建了 ${createdSections.length}/${sections.length - filteredCount} 个任务（${sections.length - createdSections.length - filteredCount} 个跳过）`);
                 // v8.3.160+: 检测是否有待拆分的功能模块
                 if (extracted.pending) {
                     logger_1.logger.info('');
@@ -1054,14 +1077,25 @@ async function iterationTaskifyCommand(options) {
                 await (0, fs_extra_1.writeFile)(reqPath, options.response);
             }
         }
-        catch {
-            const reqPath = (0, path_1.join)(iterDir, 'REQUIREMENT.md');
-            const bk = await (0, task_utils_1.backupWithTimestamp)(reqPath);
-            if (bk) {
-                backups.push(bk);
-                logger_1.logger.info(`   📦 已备份: ${bk.split('/').pop()}`);
+        catch (e) {
+            if (!jsonParsed) {
+                // JSON 解析失败 → 回退 Markdown（保留原始输出）
+                const reqPath = (0, path_1.join)(iterDir, 'REQUIREMENT.md');
+                const bk = await (0, task_utils_1.backupWithTimestamp)(reqPath);
+                if (bk) {
+                    backups.push(bk);
+                    logger_1.logger.info(`   📦 已备份: ${bk.split('/').pop()}`);
+                }
+                await (0, fs_extra_1.writeFile)(reqPath, options.response);
+            }
+            else {
+                // 任务创建过程异常 → 必须显式报错，禁止静默吞掉冒充成功
+                logger_1.logger.error(`❌ 任务创建失败: ${e?.message || e}`);
+                if (backups.length > 0)
+                    logger_1.logger.info(`   📦 已备份文件仍保留，可回滚: ${backups.join(', ')}`);
+                process.exitCode = 1;
+                return;
             }
-            await (0, fs_extra_1.writeFile)(reqPath, options.response);
         }
         // v7.4.0+: 从 AI 输出中提取疑问并持久化
         const extractedQs = (0, questions_1.extractQuestionsFromText)(options.response);
@@ -2350,8 +2384,12 @@ ${!isBk && docSet.hasComponentTree ? '| COMPONENT_TREE.md | ⏳ | ./COMPONENT_TR
     }
     // 确保至少有 backend 子任务（AI 未输出 backend 时自动补充，仅非 research）
     // v6.48.0+：从 CONSTITUTION.md 端列表查找后端端名，不再硬编码 'backend'
+    // v8.3.277: 仅当 AI 未显式声明 scope（_scopePlatforms 缺失/为空）时才自动补充；
+    // scope 已显式给出时尊重 AI 意图，不制造幽灵后端子任务
     const hasAnyBackend = taskPlatforms.some((p) => p === 'backend' || p.startsWith('后台') || /-(service|api|server|backend)$/i.test(p));
-    if (!isResearch && !hasAnyBackend) {
+    // AI 显式声明 scope 时尊重意图，不自动补后端；推断出的 scope 保留自动补充
+    const shouldAutoBackend = !section._explicitScope;
+    if (!isResearch && !hasAnyBackend && shouldAutoBackend) {
         // 从端列表查找第一个后端端名作为 fallback（v6.48.0+）
         const allPlatforms = await (0, spec_paths_1.parsePlatformList)();
         const fallbackBackend = allPlatforms.find(p => p === 'backend' || p.startsWith('后台') || /-(service|api|server|backend)$/i.test(p)) || 'backend';
@@ -2478,6 +2516,8 @@ ${taskPlatforms.map((p) => `| ${p} | 待补充 |`).join('\n')}
 }
 async function updateProjectGraph(iterationDir, sections) {
     const graphPath = (0, path_1.join)(iterationDir, '000-overview', 'PROJECT_GRAPH.md');
+    // 防护：000-overview/ 可能尚不存在（全新迭代首次拆分），写前先建目录
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(iterationDir, '000-overview'));
     let content = '';
     if (await (0, fs_extra_1.pathExists)(graphPath)) {
         content = await (0, fs_extra_1.readFile)(graphPath, 'utf-8');
@@ -3082,7 +3122,9 @@ async function readMatrixPlatforms(iterationDir, featureName) {
             return [];
         const entries = await (0, fs_extra_1.readdir)(featuresDir, { withFileTypes: true });
         for (const e of entries) {
-            if (!e.isDirectory() || !e.name.includes(featureName))
+            // v8.3.277: 排除时间戳备份目录——备份目录名仍包含 featureName，
+            // 读到旧版 _matrix.md 会返回过期的端覆盖声明
+            if (!e.isDirectory() || !e.name.includes(featureName) || (0, task_utils_1.isTimestampBackup)(e.name))
                 continue;
             const matrixPath = (0, path_1.join)(featuresDir, e.name, '_matrix.md');
             if (!(await (0, fs_extra_1.pathExists)(matrixPath)))
@@ -4674,7 +4716,8 @@ async function tryModuleDrivenSplit(iteration, iterationDir, options) {
                 try {
                     const entries = await (0, fs_extra_1.readdir)(featuresDir, { withFileTypes: true });
                     for (const entry of entries) {
-                        if (entry.isDirectory() && !entry.name.startsWith('.')) {
+                        // v8.3.277: 排除时间戳备份目录（unitize overwrite 产生的 xxx-20260924083058）
+                        if (entry.isDirectory() && !entry.name.startsWith('.') && !(0, task_utils_1.isTimestampBackup)(entry.name)) {
                             const readmePath = await (0, feature_source_1.resolveUnitSourcePath)((0, path_1.join)(featuresDir, entry.name));
                             if (await (0, fs_extra_1.pathExists)(readmePath)) {
                                 let unitPlatforms = [...allPlatforms];