speccore 8.3.15 → 8.3.17

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

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

package/dist/commands/analyze.js

@@ -461,17 +461,35 @@ async function analyzeCommand(options) {
             return;
         }
     }
-    // 模糊匹配端名
+    // v8.3.16+: 模糊匹配端名，支持多段指定（逗号分隔）
     if (options.platform) {
-        const resolved = await (0, platform_registry_1.resolvePlatform)(options.platform);
-        if (resolved.error) {
-            logger_1.logger.error(`❌ ${resolved.error}`);
+        const allPlatforms = await (0, spec_paths_1.parsePlatformList)();
+        const inputPlatforms = options.platform.split(',').map(p => p.trim()).filter(Boolean);
+        const resolvedPlatforms = [];
+        for (const input of inputPlatforms) {
+            const resolved = await (0, platform_registry_1.resolvePlatform)(input);
+            if (resolved.error) {
+                logger_1.logger.error(`❌ ${resolved.error}`);
+                return;
+            }
+            if (!resolved.exact) {
+                logger_1.logger.info(`📍 --platform ${input} → 匹配 ${resolved.resolved}`);
+            }
+            if (resolved.resolved) {
+                resolvedPlatforms.push(resolved.resolved);
+            }
+        }
+        // 过滤只保留在 CONSTITUTION.md 端列表中的端
+        const validPlatforms = resolvedPlatforms.filter(p => allPlatforms.includes(p));
+        if (validPlatforms.length === 0) {
+            logger_1.logger.error(`❌ 指定的端均不在 CONSTITUTION.md 端列表中。可用端: ${allPlatforms.join(', ')}`);
             return;
         }
-        if (!resolved.exact) {
-            logger_1.logger.info(`📍 --platform ${options.platform} → 匹配 ${resolved.resolved}`);
+        if (validPlatforms.length < resolvedPlatforms.length) {
+            const skipped = resolvedPlatforms.filter(p => !allPlatforms.includes(p));
+            logger_1.logger.warn(`⚠️ 跳过不在端列表中的端: ${skipped.join(', ')}`);
         }
-        options.platform = resolved.resolved;
+        options.platform = validPlatforms.join(',');
     }
     // 命令前索引新鲜度检查（非阻塞）
     // v6.97.0+ 修复：全局分析时不检查迭代级索引，避免误导用户
@@ -656,13 +674,44 @@ async function analyzeCommand(options) {
                 // v8.0.0+: 骨架优先架构 — CLI 预创建所有文件，AI 只覆盖内容
                 const iterDirForSkeleton = await (0, context_1.getIterationDir)(iterForDirs);
                 const specDir = (0, path_1.join)(iterDirForSkeleton, '020-specs');
-                const platforms = await (0, spec_paths_1.parsePlatformList)();
+                let platforms = await (0, spec_paths_1.parsePlatformList)();
                 const iterName = iterForDirs;
+                // v8.3.16+: 如果指定了 --platform，只创建指定端的骨架
+                if (options.platform) {
+                    const specifiedPlatforms = options.platform.split(',').map(p => p.trim()).filter(Boolean);
+                    const filtered = platforms.filter(p => specifiedPlatforms.includes(p));
+                    if (filtered.length > 0) {
+                        platforms = filtered;
+                        logger_1.logger.info(`📍 按 --platform 过滤: 只为 ${platforms.join(', ')} 端创建骨架`);
+                    }
+                    else {
+                        logger_1.logger.warn(`⚠️ --platform 指定的端不在 CONSTITUTION.md 列表中，将使用全部端`);
+                    }
+                }
                 // v7.4.3+ 兼容：先运行一次旧版 sanitize 迁移遗留文件（一次性）
                 await sanitizeSpecDirectories(iterDirForSkeleton);
-                // v8.0.0+: 计算 manifest 并生成骨架
+                // v8.3.17+: 检测新旧结构，自动选择 manifest 生成方式
                 const phase = options.phase;
-                const manifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, phase, iterName);
+                const isLegacy = await (0, spec_paths_1.isLegacySpecDir)(specDir);
+                let manifest;
+                if (isLegacy) {
+                    // 旧结构：端平铺（020-specs/{端}/）
+                    manifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, phase, iterName);
+                    logger_1.logger.info(`📂 使用旧结构（端平铺）: 020-specs/{端}/`);
+                }
+                else {
+                    // 新结构：按需求文档名组织（020-specs/{需求名}/）
+                    const features = await (0, spec_paths_1.parseFeatureList)(iterDirForSkeleton);
+                    if (features.length > 0) {
+                        manifest = (0, spec_skeleton_1.computeFeatureBasedAnalyzeManifest)(features, platforms, phase, iterName);
+                        logger_1.logger.info(`📂 使用新结构（按需求文档组织）: ${features.length} 个功能模块`);
+                    }
+                    else {
+                        // 未检测到需求文档，回退到旧结构
+                        manifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, phase, iterName);
+                        logger_1.logger.info(`📂 未检测到需求文档，回退到旧结构（端平铺）`);
+                    }
+                }
                 const skeletonResult = await (0, spec_skeleton_1.generateSkeleton)(specDir, manifest);
                 if (skeletonResult.created.length > 0) {
                     logger_1.logger.info(`🦴 已创建 ${skeletonResult.created.length} 个文件骨架: ${skeletonResult.created.join(', ')}`);
@@ -1049,6 +1098,12 @@ async function analyzeCommand(options) {
                     await (0, fs_extra_1.ensureDir)(specDir);
                     const globalSet = new Set(spec_paths_1.GLOBAL_SPEC_FILES);
                     const validPlatforms = new Set([spec_paths_1.GLOBAL_SPECS_DIR, ...(await (0, spec_paths_1.parsePlatformList)())]);
+                    // v8.3.17+: 检测是否为新结构（按需求文档组织）
+                    const isFeatureBased = !await (0, spec_paths_1.isLegacySpecDir)(specDir);
+                    const features = isFeatureBased ? await (0, spec_paths_1.parseFeatureList)(iterDir) : [];
+                    if (isFeatureBased && features.length > 0) {
+                        logger_1.logger.info(`   📂 新结构检测到 ${features.length} 个功能模块，按需求文档名路由文档`);
+                    }
                     let skippedCount = 0;
                     for (const [filename, content] of Object.entries(docs)) {
                         // v8.2.0+: 需求文档写入黄金需求目录 020-specs/requirements/
@@ -1105,6 +1160,50 @@ async function analyzeCommand(options) {
                         if (cleanFilename.startsWith(`${spec_paths_1.GLOBAL_SPECS_DIR}/`)) {
                             cleanFilename = cleanFilename.slice(`${spec_paths_1.GLOBAL_SPECS_DIR}/`.length);
                         }
+                        // v8.3.17+: 新结构路由 — 按需求文档名组织的目录结构
+                        if (isFeatureBased && cleanFilename.includes('/')) {
+                            const parts = cleanFilename.split('/');
+                            const firstPart = parts[0];
+                            // 全局文档：overview/xxx → 写入 020-specs/overview/
+                            if (firstPart === spec_paths_1.GLOBAL_SPECS_DIR) {
+                                const targetDir = (0, path_1.join)(specDir, spec_paths_1.GLOBAL_SPECS_DIR);
+                                await (0, fs_extra_1.ensureDir)(targetDir);
+                                const fp = (0, path_1.join)(targetDir, parts.slice(1).join('/'));
+                                if (!(await (0, task_utils_1.shouldOverwrite)(fp, !!options.interactive))) {
+                                    logger_1.logger.info(`   ⏭️  跳过: ${filename}`);
+                                    continue;
+                                }
+                                const bk = await (0, task_utils_1.backupWithTimestamp)(fp);
+                                if (bk) {
+                                    backups.push(bk);
+                                    logger_1.logger.info(`   📦 ${filename} 旧版已备份: ${bk.split('/').pop()}`);
+                                }
+                                await (0, fs_extra_1.writeFile)(fp, content);
+                                count++;
+                                continue;
+                            }
+                            // 功能模块路径：验证第二级是 overview/ 或合法端名
+                            if (!validPlatforms.has(firstPart) && parts.length >= 2) {
+                                const secondPart = parts[1];
+                                if (secondPart === 'overview' || validPlatforms.has(secondPart)) {
+                                    const targetDir = (0, path_1.join)(specDir, ...parts.slice(0, -1));
+                                    await (0, fs_extra_1.ensureDir)(targetDir);
+                                    const fp = (0, path_1.join)(targetDir, parts[parts.length - 1]);
+                                    if (!(await (0, task_utils_1.shouldOverwrite)(fp, !!options.interactive))) {
+                                        logger_1.logger.info(`   ⏭️  跳过: ${filename}`);
+                                        continue;
+                                    }
+                                    const bk = await (0, task_utils_1.backupWithTimestamp)(fp);
+                                    if (bk) {
+                                        backups.push(bk);
+                                        logger_1.logger.info(`   📦 ${filename} 旧版已备份: ${bk.split('/').pop()}`);
+                                    }
+                                    await (0, fs_extra_1.writeFile)(fp, content);
+                                    count++;
+                                    continue;
+                                }
+                            }
+                        }
                         // v7.4.0+: 如果 AI 携带了其他未知目录前缀（非端名），剥离前缀只保留文件名
                         if (cleanFilename.includes('/')) {
                             const prefix = cleanFilename.split('/')[0];
@@ -1123,9 +1222,10 @@ async function analyzeCommand(options) {
                             continue;
                         }
                         // 综合文档写入 overview/ 子目录，端专属文档写入 {端}/ 子目录
+                        // v8.3.16+: 多段指定时（如 api,web），不额外加目录前缀，由 AI 返回的路径决定
                         const targetDir = globalSet.has(cleanFilename)
                             ? (0, path_1.join)(specDir, spec_paths_1.GLOBAL_SPECS_DIR)
-                            : options.platform ? (0, path_1.join)(specDir, options.platform) : specDir;
+                            : (options.platform && !options.platform.includes(',')) ? (0, path_1.join)(specDir, options.platform) : specDir;
                         await (0, fs_extra_1.ensureDir)(targetDir);
                         const fp = (0, path_1.join)(targetDir, cleanFilename);
                         if (!(await (0, task_utils_1.shouldOverwrite)(fp, !!options.interactive))) {
@@ -1449,9 +1549,10 @@ async function analyzeCommand(options) {
                             skippedCount++;
                             continue;
                         }
+                        // v8.3.16+: 多段指定时（如 api,web），不额外加目录前缀，由 AI 返回的路径决定
                         const targetDir = globalSet.has(cleanFilename)
                             ? (0, path_1.join)(specDir, spec_paths_1.GLOBAL_SPECS_DIR)
-                            : options.platform ? (0, path_1.join)(specDir, options.platform) : specDir;
+                            : (options.platform && !options.platform.includes(',')) ? (0, path_1.join)(specDir, options.platform) : specDir;
                         await (0, fs_extra_1.ensureDir)(targetDir);
                         const fp = (0, path_1.join)(targetDir, cleanFilename);
                         if (!(await (0, task_utils_1.shouldOverwrite)(fp, !!options.interactive))) {
@@ -1846,6 +1947,20 @@ async function sanitizeSpecDirectories(iterDir) {
             }
             // 白名单校验：非 overview/ 且非端名的目录 → 非法
             if (!validDirs.has(entry)) {
+                // v8.3.17+: 新结构下允许功能模块目录存在
+                const isLegacy = await (0, spec_paths_1.isLegacySpecDir)(specDir);
+                if (!isLegacy) {
+                    // 新结构：只归档明显非法的目录名（纯数字、特殊符号等）
+                    if (/^\d+$/.test(entry) || /^[\.\-\*_\s]+$/.test(entry)) {
+                        const archivedName = `${entry}.invalid-${Date.now()}`;
+                        await (0, fs_extra_1.rename)(entryPath, (0, path_1.join)(specDir, archivedName));
+                        logger_1.logger.warn(`⚠️ 非法目录已归档: 020-specs/${entry}/ → ${archivedName}/`);
+                        illegalDirCount++;
+                    }
+                    // 其他目录允许存在（功能模块目录）
+                    continue;
+                }
+                // 旧结构：非 overview/ 且非端名的目录 → 非法
                 const archivedName = `${entry}.invalid-${Date.now()}`;
                 await (0, fs_extra_1.rename)(entryPath, (0, path_1.join)(specDir, archivedName));
                 logger_1.logger.warn(`⚠️ 非法目录已归档: 020-specs/${entry}/ → ${archivedName}/`);