speccore 8.3.158 → 8.3.159

package/README.md

@@ -337,7 +337,7 @@ speccore status                                       # 查看分析进度和过
 
 ```bash
 npm install -g speccore
-speccore --version   # v8.3.158
+speccore --version   # v8.3.95
 ```
 
 ## 命令列表

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

@@ -1072,13 +1072,6 @@ ${singlePrompt}`);
                 const { detectProfessionalLevel } = await Promise.resolve().then(() => __importStar(require('../core/requirement-clarifier')));
                 const reqDir = (0, path_1.join)(iterDir, '010-requirements');
                 const requirements = [];
-                // v8.3.158+: 优先读取根目录下的需求文档（用户直接放置）
-                if (await (0, fs_extra_1.pathExists)(reqDir)) {
-                    const rootFiles = await (0, fs_extra_2.readdir)(reqDir);
-                    for (const f of rootFiles.filter((f) => f.endsWith('.md') && !['INDEX.md', 'README.md', 'CLARIFY_REPORT.md', 'CHANGELOG.md'].includes(f))) {
-                        requirements.push((0, path_1.join)(reqDir, f));
-                    }
-                }
                 const reqIndex = (0, path_1.join)(reqDir, 'INDEX.md');
                 if (await (0, fs_extra_1.pathExists)(reqIndex))
                     requirements.push(reqIndex);
@@ -1540,12 +1533,7 @@ ${singlePrompt}`);
                 printBackupSummary();
                 return;
             }
-            catch (e) {
-                // v8.3.158+: JSON 解析失败时给出明确警告，避免静默 fallback 导致用户困惑
-                logger_1.logger.warn('⚠️ 多文档 JSON 解析失败，回退到单文件模式');
-                logger_1.logger.warn('   原因: AI 输出的 --apply 内容不是合法 JSON 格式');
-                logger_1.logger.info('   建议: 使用 [DOC:filename] 标记格式，或将 JSON 写入文件后用 --apply @file.json');
-                logger_1.logger.info('   当前内容将作为单文件 ANALYSIS.md 写入（内容可能不完整）');
+            catch {
                 // fallback to single-file mode
             }
         }
@@ -4238,12 +4226,7 @@ sequenceDiagram
             if (iterDir) {
                 const specDir = (0, path_1.join)(iterDir, '020-specs');
                 const platforms = await (0, spec_paths_1.parsePlatformList)();
-                // v8.3.158+: 骨架进度检测必须使用与骨架生成一致的 manifest（功能模块结构）
-                const features = await (0, spec_paths_1.parseFeatureList)(iterDir);
-                const useFeatureMode = features.length > 0;
-                const manifest = useFeatureMode
-                    ? (0, spec_skeleton_1.computeFeatureBasedAnalyzeManifest)(features, platforms, undefined, ctx.iteration)
-                    : (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
+                const manifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
                 perDocStatus = await (0, spec_skeleton_1.detectSkeletonProgress)(specDir, manifest);
                 if (perDocStatus.nextUnfilled) {
                     const nextDocName = perDocStatus.nextUnfilled.docName;
@@ -4299,47 +4282,41 @@ sequenceDiagram
                     if (missingDocs.length > 0) {
                         logger_1.logger.warn(`⚠️ DOC_MATRIX 交叉校验发现 ${missingDocs.length} 个全局文档缺失（不在骨架清单中但应该存在）: ${missingDocs.join(', ')}`);
                         logger_1.logger.info(`🔧 自动补建骨架文件...`);
-                        // 为缺失文档补建骨架（使用与当前模式一致的 manifest）
-                        const missingEntries = (useFeatureMode
-                            ? (0, spec_skeleton_1.computeFeatureBasedAnalyzeManifest)(features, platforms, '1', ctx.iteration)
-                            : (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, '1', ctx.iteration)).filter(e => missingDocs.includes(e.docName));
+                        // 为缺失文档补建骨架
+                        const missingEntries = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, '1', ctx.iteration)
+                            .filter(e => missingDocs.includes(e.docName));
                         if (missingEntries.length > 0) {
                             await (0, spec_skeleton_1.generateSkeleton)(specDir, missingEntries);
                             logger_1.logger.info(`✅ 已补建 ${missingEntries.length} 个骨架文件，请继续填充`);
                             // 重新检测进度（现在有了新骨架）
-                            const newManifest = useFeatureMode
-                                ? (0, spec_skeleton_1.computeFeatureBasedAnalyzeManifest)(features, platforms, undefined, ctx.iteration)
-                                : (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
+                            const newManifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
                             perDocStatus = await (0, spec_skeleton_1.detectSkeletonProgress)(specDir, newManifest);
                         }
                     }
                     // v8.1.1+: Phase 2 平台文档交叉校验
-                    // v8.3.158+: 功能模块模式下跳过旧结构交叉校验（平台文档按功能模块组织，不在 020-specs/{端}/ 下）
-                    if (!useFeatureMode) {
-                        const expectedPlatformDocs = PLATFORM_DOCS.filter(d => includeDocs.includes(d));
-                        const missingPlatformDocs = [];
-                        for (const platform of platforms) {
-                            for (const doc of expectedPlatformDocs) {
-                                const docPath = (0, path_1.join)(specDir, platform, doc);
-                                if (!await (0, fs_extra_1.pathExists)(docPath)) {
-                                    missingPlatformDocs.push(`${platform}/${doc}`);
-                                }
+                    const expectedPlatformDocs = PLATFORM_DOCS.filter(d => includeDocs.includes(d));
+                    const missingPlatformDocs = [];
+                    for (const platform of platforms) {
+                        for (const doc of expectedPlatformDocs) {
+                            const docPath = (0, path_1.join)(specDir, platform, doc);
+                            if (!await (0, fs_extra_1.pathExists)(docPath)) {
+                                missingPlatformDocs.push(`${platform}/${doc}`);
                             }
                         }
-                        if (missingPlatformDocs.length > 0) {
-                            logger_1.logger.warn(`⚠️ DOC_MATRIX 交叉校验发现 ${missingPlatformDocs.length} 个平台文档缺失: ${missingPlatformDocs.slice(0, 5).join(', ')}${missingPlatformDocs.length > 5 ? '...' : ''}`);
-                            logger_1.logger.info(`🔧 自动补建平台骨架文件...`);
-                            const missingPlatformEntries = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, '2', ctx.iteration)
-                                .filter(e => {
-                                const relName = e.relPath;
-                                return missingPlatformDocs.some(mp => relName.endsWith(mp) || mp.endsWith(relName));
-                            });
-                            if (missingPlatformEntries.length > 0) {
-                                await (0, spec_skeleton_1.generateSkeleton)(specDir, missingPlatformEntries);
-                                logger_1.logger.info(`✅ 已补建 ${missingPlatformEntries.length} 个平台骨架文件，请继续填充`);
-                                const newManifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
-                                perDocStatus = await (0, spec_skeleton_1.detectSkeletonProgress)(specDir, newManifest);
-                            }
+                    }
+                    if (missingPlatformDocs.length > 0) {
+                        logger_1.logger.warn(`⚠️ DOC_MATRIX 交叉校验发现 ${missingPlatformDocs.length} 个平台文档缺失: ${missingPlatformDocs.slice(0, 5).join(', ')}${missingPlatformDocs.length > 5 ? '...' : ''}`);
+                        logger_1.logger.info(`🔧 自动补建平台骨架文件...`);
+                        const missingPlatformEntries = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, '2', ctx.iteration)
+                            .filter(e => {
+                            const relName = e.relPath; // e.g. "overview/TECH.md" relative to specDir
+                            return missingPlatformDocs.some(mp => relName.endsWith(mp) || mp.endsWith(relName));
+                        });
+                        if (missingPlatformEntries.length > 0) {
+                            await (0, spec_skeleton_1.generateSkeleton)(specDir, missingPlatformEntries);
+                            logger_1.logger.info(`✅ 已补建 ${missingPlatformEntries.length} 个平台骨架文件，请继续填充`);
+                            const newManifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
+                            perDocStatus = await (0, spec_skeleton_1.detectSkeletonProgress)(specDir, newManifest);
                         }
                     }
                 }
@@ -4615,19 +4592,6 @@ status: "clarified"
                 else {
                     // 回退：从 010-requirements/ 读取原始需求
                     const reqDir = (0, path_1.join)(iterDirForCtx, '010-requirements');
-                    // v8.3.158+: 优先读取根目录下的 .md 文件（用户直接放置的需求文档）
-                    const rootFiles = (await Promise.resolve().then(() => __importStar(require('fs-extra')))).readdirSync(reqDir).filter((f) => f.endsWith('.md') && !['INDEX.md', 'README.md', 'CLARIFY_REPORT.md', 'CHANGELOG.md'].includes(f));
-                    if (rootFiles.length > 0) {
-                        for (const f of rootFiles.slice(0, 10)) {
-                            const filePath = (0, path_1.join)(reqDir, f);
-                            let content = await (await Promise.resolve().then(() => __importStar(require('fs-extra')))).readFile(filePath, 'utf-8');
-                            content = await (0, prompt_builder_1.processMarkdownContent)(content, filePath, seenPaths, undefined, {
-                                maxLinkDepth: 2, maxLinkChars: 1200, maxSvgChars: 1500,
-                            });
-                            prdContent += `\n### ${f}\n${content.slice(0, 3000)}\n`;
-                        }
-                    }
-                    // 再读取子目录中的需求文档（兼容旧结构）
                     const prdSources = (0, path_1.join)(reqDir, 'sources');
                     const prdConverted = (0, path_1.join)(reqDir, 'converted');
                     const prdFeatures = (0, path_1.join)(reqDir, 'features');
@@ -4822,13 +4786,12 @@ status: "clarified"
             prompt += `   ⚠️ 如果全局层产物不存在，跳过该项，继续后续分析\n\n`;
             prompt += `3. 读取迭代需求文档（按优先级顺序）：\n`;
             prompt += `   a. 先读 010-requirements/INDEX.md — 了解需求全貌和文件清单\n`;
-            prompt += `   b. 再读 010-requirements/根目录下的 *.md 文件 — 用户直接放置的核心需求文档（最高优先级）\n`;
-            prompt += `   c. 再读 010-requirements/converted/*.md — doc2spec 转换后的核心规格\n`;
-            prompt += `   d. 再读 010-requirements/features/*/README.md — 功能级补充需求\n`;
-            prompt += `   e. 读取 010-requirements/prototypes/ — 原型文件（HTML/图片/链接均读取）\n`;
+            prompt += `   b. 再读 010-requirements/converted/*.md — doc2spec 转换后的核心规格（主要依据）\n`;
+            prompt += `   c. 再读 010-requirements/features/*/README.md — 功能级补充需求\n`;
+            prompt += `   d. 读取 010-requirements/prototypes/ — 原型文件（HTML/图片/链接均读取）\n`;
             prompt += `      ⚠️ 需求文档中链接到原型的（如 \`![原型](../prototypes/xxx.png)\` 或 \`详见 prototypes/xxx.html\`），必须主动 Read 该原型文件\n`;
-            prompt += `   f. 如用户指定了特定文档，优先读取指定文件；如要求全部，再读 sources/ 原始文档\n`;
-            prompt += `   g. **文档长度自适应**：如果单个需求文档超过 5000 字，先快速扫描目录和章节标题，标记关键章节，再深入阅读。不要在非关键章节上花费过多 tokens\n`;
+            prompt += `   e. 如用户指定了特定文档，优先读取指定文件；如要求全部，再读 sources/ 原始文档\n`;
+            prompt += `   f. **文档长度自适应**：如果单个需求文档超过 5000 字，先快速扫描目录和章节标题，标记关键章节，再深入阅读。不要在非关键章节上花费过多 tokens\n`;
             prompt += `4. 读懂需求文档后，按专业模板标准自由撰写每个文档（不是填空表）\n`;
             prompt += `5. **文档忠实度约束（最高优先级）**：\n`;
             prompt += `   - **严禁臆造**：只能写需求文档中明确提及的功能、接口、页面、字段、业务规则\n`;
@@ -5464,11 +5427,10 @@ async function buildClarifyPhasePrompt(iteration) {
     prompt += `\n## 读取需求文档\n\n`;
     prompt += `依次读取以下文档（按优先级）：\n`;
     prompt += `1. \`010-requirements/INDEX.md\` — 需求全貌\n`;
-    prompt += `2. \`010-requirements/根目录下的 *.md 文件\` — 用户直接放置的核心需求文档（最高优先级）\n`;
+    prompt += `2. \`010-requirements/sources/*.md\` — 原始需求（主要依据）\n`;
     prompt += `3. \`010-requirements/converted/*.md\` — 已转换文档\n`;
     prompt += `4. \`010-requirements/features/*/README.md\` — 功能级补充\n`;
-    prompt += `5. \`010-requirements/prototypes/\` — 原型文件\n`;
-    prompt += `6. \`010-requirements/sources/*.md\` — 原始需求（补充参考）\n\n`;
+    prompt += `5. \`010-requirements/prototypes/\` — 原型文件\n\n`;
     // v8.2.0+: 如果检测到多个功能单元，启用单元化澄清模式
     if (hasMultipleUnits) {
         prompt += `## ⚠️ 功能单元拆分澄清模式（v8.2.0+）\n\n`;