speccore 8.3.263 → 8.3.267

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":"AA2FA,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5C,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiPD,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA81E3E;AA+zBD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsuEzU;AAopBD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,eAAe,kCAAkC,CAAC;AAE/D,oBAAoB;AACpB,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAkGrF;AAED,kBAAkB;AAClB,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/F;AAED,iBAAiB;AACjB,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBjF;AAED,iBAAiB;AACjB,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB/G;AAcD,oCAAoC;AACpC,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EAAE,EACtB,QAAQ,EAAE,YAAY,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAmFjB;AAkBD,2BAA2B;AAC3B,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CAAC,MAAM,CAAC,CA0EjB;AAoYD;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8D7H"}

package/dist/commands/analyze.js

@@ -83,6 +83,13 @@ const dispatch_loop_1 = require("../core/dispatch-loop");
 const pipeline_engine_1 = require("../core/pipeline-engine");
 const change_detection_1 = require("../core/change-detection");
 const ai_trace_1 = require("../utils/ai-trace");
+// v8.3.264: AI 交棒统一出口——所有 [SPECCORE_PROMPT] 输出必留 prompt-out 轨迹，
+// 与 ai-trace 飞行记录仪的 apply-in/apply-done/apply-fail 配对，形成「发起→回传→落盘」闭环证据链。
+// 此前 14 处输出点仅 2 处埋点，澄清链等 12 处交棒全程无痕（ai-trace/ 目录空白即因此）。
+async function emitAiPrompt(iter, prompt, meta = {}) {
+    await (0, ai_trace_1.recordAiTrace)(iter, 'prompt-out', { promptLength: prompt.length, ...meta, prompt });
+    process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+}
 const streaming_analyzer_1 = require("../core/streaming-analyzer");
 const requirement_clarifier_1 = require("../core/requirement-clarifier");
 const agents_1 = require("../core/agents");
@@ -405,7 +412,7 @@ async function analyzeCommand(options) {
         prompt += `3. 修复后重新运行 \`speccore analyze -I ${iter}\` 重新审计\n`;
         prompt += `4. 最多修复 2 轮，超过 2 轮仍有问题则标记为“需人工确认”\n`;
         prompt += `5. 写入: speccore analyze --apply '{...}' -I ${iter}\n`;
-        process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+        await emitAiPrompt(iter, prompt, { mode: 'audit-fix' });
         process.exitCode = 10;
         return;
     }
@@ -428,7 +435,7 @@ async function analyzeCommand(options) {
         if (options.estimateOnly) {
             // 只输出预估报告到 prompt
             const prompt = buildContextGuardPrompt(estimate, plan);
-            process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+            await emitAiPrompt(iter, prompt, { mode: 'context-guard' });
             process.exitCode = 10;
             return;
         }
@@ -458,7 +465,7 @@ async function analyzeCommand(options) {
         logger_1.logger.info('');
         if (options.prompt) {
             const prompt = buildIncrementalPrompt(iterDir, analysis, iter);
-            process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+            await emitAiPrompt(iter, prompt, { mode: 'incremental' });
             process.exitCode = 10;
             return;
         }
@@ -505,7 +512,7 @@ async function analyzeCommand(options) {
         logger_1.logger.info('');
         if (options.prompt) {
             const prompt = buildNewPlatformPrompt(iterDir, analysis, iter);
-            process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+            await emitAiPrompt(iter, prompt, { mode: 'new-platform' });
             process.exitCode = 10;
             return;
         }
@@ -556,7 +563,7 @@ async function analyzeCommand(options) {
         logger_1.logger.info('');
         if (options.prompt) {
             const prompt = buildModuleAnalysisPrompt(iterDir, result, iter);
-            process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+            await emitAiPrompt(iter, prompt, { mode: 'module-analysis' });
             process.exitCode = 10;
             return;
         }
@@ -670,7 +677,7 @@ async function analyzeCommand(options) {
         }
         // ── prompt 模式：生成 AI Prompt ──
         const prompt = buildOverviewPrompt(overviewInput, coverage, crossApis, phase);
-        process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+        await emitAiPrompt(iter, prompt, { mode: 'overview' });
         process.exitCode = 10;
         return;
     }
@@ -707,6 +714,25 @@ async function analyzeCommand(options) {
                 return;
             }
         }
+        else if (options.autoUnits || options.resumeUnits) {
+            // v8.3.266+: 缓存与磁盘 features/ 权威源对照——旧缓存可能含 unitize 重切前的假单元
+            // （实测会议项目 23 个缓存单元中 6 个在 features/ 不存在），调度循环会给假单元生成
+            // Prompt 写到 features 锚点之外的目录，白写且 taskify/Phase 2 均不读。
+            const diskUnits = await extractIterationUnits(iterDir);
+            const cacheNames = new Set(units.map((u) => u.name));
+            const diskNames = new Set(diskUnits.map((u) => u.name));
+            const mismatched = diskUnits.length > 0
+                && (diskUnits.length !== units.length || [...diskNames].some((n) => !cacheNames.has(n)));
+            if (mismatched) {
+                units = diskUnits;
+                await (0, fs_extra_1.ensureDir)((0, path_1.dirname)(unitsCachePath));
+                await (0, fs_extra_1.writeFile)(unitsCachePath, JSON.stringify(units, null, 2));
+                logger_1.logger.warn(`⚠️ 单元清单与磁盘 features/ 目录不一致，已刷新: ${units.length} 个`);
+                for (const u of units) {
+                    logger_1.logger.info(`   ${u.id}: ${u.name} (${u.source}#L${u.sourceRange.startLine})`);
+                }
+            }
+        }
         // Step 2: 汇总模式（--consolidate）
         if (options.consolidate) {
             const analyses = await loadUnitAnalyses(iter);
@@ -717,7 +743,7 @@ async function analyzeCommand(options) {
             }
             const report = await consolidateUnitAnalyses(iter, units, analyses);
             if (options.prompt) {
-                process.stdout.write(`[SPECCORE_PROMPT]\n${report}\n\n## 操作选项\n\n**选项 A：确认通过，写入所有文档**\n\`\`\`bash\nspeccore analyze --apply '[DOC:...]' -I ${iter}\n\`\`\`\n`);
+                await emitAiPrompt(iter, `${report}\n\n## 操作选项\n\n**选项 A：确认通过，写入所有文档**\n\`\`\`bash\nspeccore analyze --apply '[DOC:...]' -I ${iter}\n\`\`\`\n`, { mode: 'consolidate-report' });
                 process.exitCode = 10;
                 return;
             }
@@ -764,14 +790,33 @@ async function analyzeCommand(options) {
         //   CLI 每轮推进状态机：校验产出 → 已就绪自动标记并推进，未就绪输出该单元 prompt（exitCode 10）
         //   → 宿主 AI 落盘 → 再次调用本命令 → CLI 校验通过自动推进下一个单元，直到全部完成
         if (options.autoUnits || options.resumeUnits) {
-            const loopResult = await runUnitDispatchLoop(iter, iterDir, units);
-            if (loopResult.finished) {
-                await printUnitLoopSummary(iter, iterDir, units, loopResult);
-                return;
+            // v8.3.266: Qoder 环境非 TTY 下优先 SDK 派单——CLI 进程内直接调起子 Agent
+            // （独立上下文、acceptEdits 直接写文件），校验通过后自动推进下一单元，宿主全程
+            // 不参与；SDK 不可用/失败时回退标记模式（exitCode 10 宿主接力）。
+            // 收敛性：每轮单元状态必然前进（done/failed）或 SDK 失败退出，不会死循环。
+            const sdkSupported = !process.stdout.isTTY && (0, agent_adapter_1.isSdkDispatchSupported)();
+            const maxDispatchRounds = units.length * 3 + 5; // 防御性上限（每单元最多 3 次尝试 + 余量）
+            let dispatchCount = 0;
+            while (true) {
+                const loopResult = await runUnitDispatchLoop(iter, iterDir, units);
+                if (loopResult.finished) {
+                    await printUnitLoopSummary(iter, iterDir, units, loopResult);
+                    return;
+                }
+                const fallbackPrompt = `${loopResult.prompt}\n\n## 完成后继续\n\n落盘后运行以下命令，CLI 将校验产出并自动推进到下一个单元：\n\n\`\`\`bash\nspeccore analyze --resume-units -I ${iter}\n\`\`\`\n`;
+                if (!sdkSupported || !(await trySdkDispatchUnit(loopResult.prompt, iter, loopResult.step.name))) {
+                    // 回退标记模式（非 Qoder 宿主 / TTY / SDK 失败均走此路径）
+                    await emitAiPrompt(iter, fallbackPrompt, { mode: 'resume-units-loop' });
+                    process.exitCode = 10;
+                    return;
+                }
+                if (++dispatchCount >= maxDispatchRounds) {
+                    logger_1.logger.warn(`⚠️ SDK 派单轮次超限（${maxDispatchRounds}），退出调度循环`);
+                    process.exitCode = 10;
+                    return;
+                }
             }
-            process.stdout.write(`[SPECCORE_PROMPT]\n${loopResult.prompt}\n\n## 完成后继续\n\n落盘后运行以下命令，CLI 将校验产出并自动推进到下一个单元：\n\n\`\`\`bash\nspeccore analyze --resume-units -I ${iter}\n\`\`\`\n`);
-            process.exitCode = 10;
-            return;
+            // 理论不可达：while(true) 内所有路径均 return
         }
         // 3c. --unit: 指定单元（支持逗号分隔多个，如 M-01,M-03）
         if (options.unit) {
@@ -806,8 +851,7 @@ async function analyzeCommand(options) {
             const targetUnit = targetUnits[0];
             if (options.prompt) {
                 const prompt = await buildUnitAnalysisPrompt(iterDir, iter, targetUnit, units);
-                await (0, ai_trace_1.recordAiTrace)(iter, 'prompt-out', { mode: 'unit', unit: targetUnit.id, promptLength: prompt.length, prompt });
-                process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+                await emitAiPrompt(iter, prompt, { mode: 'unit', unit: targetUnit.id });
                 process.exitCode = 10;
                 return;
             }
@@ -1464,7 +1508,7 @@ async function analyzeCommand(options) {
                 process.stdout.write(`[SPECCORE_CONTEXT_BUDGET: 8000]\n`);
                 process.stdout.write(`[SPECCORE_CONTEXT_TYPE: platform-only]\n\n`);
             }
-            process.stdout.write(`[SPECCORE_PROMPT]\n${finalPrompt}`);
+            await emitAiPrompt(iter, finalPrompt, { mode: 'subagent-final' });
             process.exitCode = 10;
             return;
         }
@@ -1494,7 +1538,7 @@ async function analyzeCommand(options) {
             if (shouldClarify) {
                 // 需要澄清，先执行 clarify（内部已生成质量报告）
                 const clarifyPrompt = await buildClarifyPhasePrompt(iter);
-                process.stdout.write(`[SPECCORE_PROMPT]\n${clarifyPrompt}`);
+                await emitAiPrompt(iter, clarifyPrompt, { mode: 'clarify-phase' });
                 process.exitCode = 10;
                 return;
             }
@@ -1508,7 +1552,7 @@ async function analyzeCommand(options) {
             analyzeOptions: options,
         });
         const prompt = (0, prompt_builder_1.buildPromptText)(promptObj);
-        process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+        await emitAiPrompt(iter, prompt, { mode: 'analyze-host' });
         process.exitCode = 10;
         return;
     }
@@ -1759,6 +1803,8 @@ async function analyzeCommand(options) {
         const clarifyBlocks = parseClarifyMarkers(options.apply);
         if (clarifyBlocks.size > 0 && !isGlobalScope) {
             logger_1.logger.info(`📋 检测到 ${clarifyBlocks.size} 个澄清文档，先写入...`);
+            // v8.3.267: 提前取真实功能单元名集合（只取一次），供幽灵路由判定
+            const validFeatures = new Set(iterDir ? await (0, spec_paths_2.parseFeatureList)(iterDir) : []);
             for (const [filename, content] of clarifyBlocks) {
                 const { parseClarifiedRequirement, buildClarifiedHeader } = await Promise.resolve().then(() => __importStar(require('../core/requirement-clarifier')));
                 const { content: cleaned } = parseClarifiedRequirement(content);
@@ -1767,7 +1813,25 @@ async function analyzeCommand(options) {
                 // 解析写入路径：支持新格式（overview/、{feature}/overview/）和旧格式（requirements/）
                 let fp;
                 if (filename.includes('/') || filename.includes('\\')) {
-                    fp = (0, path_1.join)(iterDir, '020-specs', filename);
+                    // v8.3.267: 幽灵路由归一化——AI 常把「文档 slug」当 feature-name 生成
+                    // [CLARIFY:overview/overview/CLARIFY.md]、[CLARIFY:admin-web/overview/CLARIFY.md]
+                    // 等标记，原样落地会产出 overview/overview/、admin-web/ 等幽灵目录。
+                    // 首段不是真实功能单元时：
+                    //   「overview」→ 全局澄清 020-specs/overview/CLARIFY.md
+                    //   其余文档 slug → 文档级黄金需求 020-specs/requirements/{slug}-clarified.md
+                    const seg = filename.split(/[\\/]/)[0];
+                    const isUnitOverview = /^[^\\/]+\/overview\/CLARIFY\.md$/i.test(filename);
+                    if (isUnitOverview && seg === 'overview') {
+                        fp = (0, path_1.join)(iterDir, '020-specs', 'overview', 'CLARIFY.md');
+                        logger_1.logger.warn(`   ↪ ${filename} 首段「overview」为全局澄清，已归一化到 020-specs/overview/CLARIFY.md`);
+                    }
+                    else if (isUnitOverview && !validFeatures.has(seg)) {
+                        fp = (0, path_1.join)(iterDir, '020-specs', 'requirements', `${seg}-clarified.md`);
+                        logger_1.logger.warn(`   ↪ ${filename} 首段「${seg}」非功能单元，已路由到 requirements/${seg}-clarified.md（文档级黄金需求）`);
+                    }
+                    else {
+                        fp = (0, path_1.join)(iterDir, '020-specs', filename);
+                    }
                 }
                 else {
                     // 兼容旧格式：无路径前缀的文件名写入 requirements/
@@ -1939,7 +2003,7 @@ async function analyzeCommand(options) {
                         logger_1.logger.info(`   1. 读取上述问题文档的当前内容`);
                         logger_1.logger.info(`   2. 根据质量报告中的错误信息补充/修正内容`);
                         logger_1.logger.info(`   3. 用 speccore global analyze --apply '{"文件路径":"修正后内容"}' 重新写入`);
-                        process.stdout.write(`\n[SPECCORE_PROMPT]\n# 质量门禁修复任务\n\n以下全局分析文档未通过质量校验，请修复后重新写入：\n\n`);
+                        await emitAiPrompt(options.iteration || 'GLOBAL', `\n# 质量门禁修复任务\n\n以下全局分析文档未通过质量校验，请修复后重新写入：\n\n`, { mode: 'global-gate-fix' });
                         for (const r of criticalErrors.slice(0, 5)) {
                             const fname = r.file.split('/').slice(-2).join('/');
                             const errs = r.issues.filter(i => i.severity === 'error').map(i => `- ${i.message}`).join('\n');
@@ -2656,8 +2720,7 @@ async function analyzeCommand(options) {
             catch { /* ignore */ }
         }
         const prompt = await buildMultiDocPrompt('analyze', { iteration: iter, scope: options.scope, withCode: options.withCode, platform: options.platform, phase: options.phase, autoMode: options.auto }, options, needsClarify ? { needsClarify, clarifyTargets } : undefined);
-        await (0, ai_trace_1.recordAiTrace)(iter, 'prompt-out', { mode: 'analyze-main', scope: options.scope, promptLength: prompt.length, prompt });
-        process.stdout.write(`[SPECCORE_PROMPT]\n${prompt}`);
+        await emitAiPrompt(iter, prompt, { mode: 'analyze-main', scope: options.scope });
         // v7.2.0+: 全局分析完成后输出下一步引导
         if (options.scope === 'global') {
             const guide = await buildGlobalAnalysisGuide(options);
@@ -6354,12 +6417,26 @@ async function extractIterationUnits(iterDir) {
     const featuresDir = (0, path_1.join)(reqDir, 'features');
     if (await (0, fs_extra_1.pathExists)(featuresDir)) {
         const entries = await (0, fs_extra_2.readdir)(featuresDir, { withFileTypes: true });
-        const dirs = entries.filter(e => e.isDirectory() && !e.name.startsWith('.') && !e.name.startsWith('_'));
+        // v8.3.267: 过滤 overview- 前缀的全局章节目录（unitize 误切产物，
+        // 如「核心业务规则跨端通用」），防止假单元混入调度循环
+        const dirs = entries.filter(e => e.isDirectory() && !e.name.startsWith('.') && !e.name.startsWith('_') && !e.name.startsWith('overview-'));
         for (const dir of dirs) {
             const readmePath = await (0, feature_source_1.resolveUnitSourcePath)((0, path_1.join)(featuresDir, dir.name));
             let content = '';
             if (await (0, fs_extra_1.pathExists)(readmePath)) {
-                content = (await (0, fs_extra_2.readFile)(readmePath, 'utf-8')).slice(0, 500);
+                // v8.3.267: 图片引用可能落在 500 字符截断之外，显式保留引用行，
+                // 保证单元上下文的图片清单完整（AI 可据此 Read 原型图）
+                const full = await (0, fs_extra_2.readFile)(readmePath, 'utf-8');
+                content = full.slice(0, 500);
+                const imgRefs = new Set();
+                const imgRe = /!\[[^\]]*\]\(([^)\s]+)\)/g;
+                let m;
+                while ((m = imgRe.exec(full)) !== null)
+                    imgRefs.add(m[1]);
+                const outside = [...imgRefs].filter(r => !content.includes(r));
+                if (outside.length > 0) {
+                    content += `\n\n<!-- 原文图片引用（截断外保留）-->\n${outside.map(r => `![图片](${r})`).join('\n')}`;
+                }
             }
             units.push({
                 id: `M-${String(idCounter++).padStart(2, '0')}`,
@@ -6465,7 +6542,9 @@ async function loadUnitAnalyses(iteration) {
 async function detectPendingUnits(iteration, allUnits) {
     const completed = await loadUnitAnalyses(iteration);
     const completedIds = new Set(completed.map(a => a.id));
-    const iterDir = `Iteration-${iteration.replace(/^Iteration-/, '')}`;
+    // v8.3.266+: 用绝对路径迭代目录替代相对路径拼接——cwd 不在迭代父目录时旧写法会指向错误路径，
+    // 导致 unitHasSkeletonOutput 兜底检查全部误判为骨架（路径不存在）
+    const iterDir = await (0, context_1.getIterationDir)(iteration);
     const pending = [];
     for (const u of allUnits) {
         if (!completedIds.has(u.id)) {
@@ -6859,6 +6938,7 @@ async function buildUnitLoopPrompt(iterDir, iter, unit, allUnits, attempt, lastE
 约束：
 - 每个文件内容不少于 200 字符，禁止输出空模板或骨架占位
 - 写入前先创建目录；写完后回复一行：\`DONE ${unit.name}\`
+- 若上下文中含「需求图片/原型」或 \`![...](...)\` 图片引用，请先用 Read 工具打开图片文件查看，再结合图片信息撰写规格；不要忽略图片提示
 `;
     if (attempt > 1 && lastError) {
         extra += `
@@ -6871,6 +6951,89 @@ async function buildUnitLoopPrompt(iterDir, iter, unit, allUnits, attempt, lastE
     }
     return base + extra;
 }
+/**
+ * v8.3.266: 调度循环 SDK 派单——Qoder 环境非 TTY 下由 CLI 直接调起子 Agent
+ * （独立上下文、acceptEdits 直接写文件），返回 true 表示派单成功（含自动落盘）。
+ */
+async function trySdkDispatchUnit(prompt, iter, unitName) {
+    try {
+        const agentCtx = {
+            subagent: 'requirement-analyzer',
+            iteration: iter,
+            contextBudget: 6000,
+            contextType: 'incremental',
+            cwd: (0, task_utils_1.findProjectRoot)() || process.cwd(),
+        };
+        const dispatchResult = await (0, agent_adapter_1.dispatchSubagent)(agentCtx, prompt);
+        if (!dispatchResult || !dispatchResult.success) {
+            logger_1.logger.debug('[analyze] SDK 派单未成功，回退标记模式');
+            return false;
+        }
+        // v8.3.266: 防御空转——success 但既没写文件也没返回可落盘内容，视为无效派单，
+        // 立即回退标记模式（否则循环会白白耗尽该单元 3 次尝试并误标 failed）
+        if (!dispatchResult.content && (!dispatchResult.filesChanged || dispatchResult.filesChanged.length === 0)) {
+            logger_1.logger.warn('[analyze] SDK 派单无产出（未写文件且无回传内容），回退标记模式');
+            return false;
+        }
+        logger_1.logger.info(`[analyze] 调度循环子 Agent SDK 派单成功: ${unitName}`);
+        // v8.3.196+ 自动落盘：子 Agent 未直接写文件时，解析其返回的 JSON/[DOC:] 内容
+        // 并路由到该单元的 overview/ 目录（applyDocContent 无单元路由，此处专用落盘）
+        if (dispatchResult.content) {
+            const autoApplied = await applyUnitLoopDocs(dispatchResult.content, iter, unitName);
+            if (autoApplied > 0) {
+                process.stdout.write(`✅ 已自动写入 ${autoApplied} 个文档到 020-specs/${sanitizeUnitDirName(unitName)}/overview/\n`);
+            }
+        }
+        if (dispatchResult.filesChanged && dispatchResult.filesChanged.length > 0) {
+            process.stdout.write(`📄 文件变更: ${dispatchResult.filesChanged.join(', ')}\n`);
+        }
+        return true;
+    }
+    catch (e) {
+        logger_1.logger.debug(`[analyze] SDK 派单异常: ${e.message}，回退标记模式`);
+        return false;
+    }
+}
+/**
+ * v8.3.266: 把子 Agent 回传的 JSON/[DOC:] 内容写入指定单元的 overview/ 目录。
+ * 文档名归一化：analyze prompt 用 [DOC:REQ.md]，落盘用 REQUIREMENT.md（validateUnitSpec 校验名单）。
+ */
+async function applyUnitLoopDocs(content, iter, unitName) {
+    const trimmed = content.trim();
+    if (!trimmed)
+        return 0;
+    const iterDir = await (0, context_1.getIterationDir)(iter);
+    const unitDir = (0, path_1.join)(iterDir, '020-specs', sanitizeUnitDirName(unitName), 'overview');
+    let docs = {};
+    if (trimmed.startsWith('{')) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+                docs = parsed;
+        }
+        catch { /* 回退 [DOC:] 标记 */ }
+    }
+    if (Object.keys(docs).length === 0) {
+        for (const [name, c] of parseDocMarkers(trimmed))
+            docs[name] = c;
+    }
+    if (Object.keys(docs).length === 0)
+        return 0;
+    const NAME_MAP = { 'REQ.md': 'REQUIREMENT.md' };
+    let applied = 0;
+    for (const [filename, docContent] of Object.entries(docs)) {
+        if (typeof docContent !== 'string' || !docContent.trim())
+            continue;
+        const baseName = (filename.split('/').pop() || filename).trim();
+        const normalized = NAME_MAP[baseName] || baseName;
+        if (!normalized.endsWith('.md') || normalized.startsWith('.'))
+            continue;
+        await (0, fs_extra_1.ensureDir)(unitDir);
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(unitDir, normalized), docContent);
+        applied++;
+    }
+    return applied;
+}
 /** 单元分析调度循环：构建步骤清单并推进一轮 */
 async function runUnitDispatchLoop(iter, iterDir, units) {
     const steps = units.map((u) => ({
@@ -6900,9 +7063,49 @@ async function printUnitLoopSummary(iter, iterDir, units, result) {
         logger_1.logger.success(`🎉 所有 ${s.done.length} 个功能单元分析完成！`);
     }
     logger_1.logger.info(`   下一步: 汇总统一报告 speccore analyze --prompt -I ${iter} --consolidate`);
+    // v8.3.266+: 循环只保证 overview/ 3 份，端级文档（{feature}/{端}/）由 Phase 2 负责——
+    // 此前完成提示不提 Phase 2，用户以为分析已闭环，taskify 时端级内容仍是骨架
+    const platformSk = await countPlatformSkeletons(iterDir);
+    if (platformSk.total > 0 && platformSk.skeleton > 0) {
+        logger_1.logger.warn(`⚠️ 端级文档仍有 ${platformSk.skeleton}/${platformSk.total} 份为骨架（overview/ 之外）`);
+        logger_1.logger.info(`   Phase 2 生成各端专属文档: speccore analyze --prompt -I ${iter} --phase 2`);
+    }
     // v8.3.234+: 执行完成质量报告（成功/失败清单 + 产出物评分）落盘 QUALITY_AUDIT.md
     await buildAndSaveQualityReport(iterDir, iter, units);
 }
+/**
+ * v8.3.266+: 统计 020-specs/{feature}/{端}/ 下仍为骨架的 .md 文件数。
+ * 用于调度循环完成后引导 Phase 2（调度循环只保证 overview/ 3 份落盘）。
+ */
+async function countPlatformSkeletons(iterDir) {
+    let skeleton = 0;
+    let total = 0;
+    try {
+        const specDir = (0, path_1.join)(iterDir, '020-specs');
+        if (!(await (0, fs_extra_1.pathExists)(specDir)))
+            return { skeleton, total };
+        const features = await (0, spec_paths_2.parseFeatureList)(iterDir);
+        const platforms = await (0, spec_paths_2.parsePlatformList)();
+        for (const feature of features) {
+            for (const platform of platforms) {
+                const pDir = (0, path_1.join)(specDir, feature, platform);
+                if (!(await (0, fs_extra_1.pathExists)(pDir)))
+                    continue;
+                const entries = await (0, fs_extra_2.readdir)(pDir, { withFileTypes: true }).catch(() => []);
+                for (const entry of entries) {
+                    if (!entry.name.endsWith('.md') || !entry.isFile())
+                        continue;
+                    total++;
+                    const content = (await (0, fs_extra_2.readFile)((0, path_1.join)(pDir, entry.name), 'utf-8').catch(() => '')).trim();
+                    if (!content || content.includes('SPEC-SKELETON') || content.length < 200)
+                        skeleton++;
+                }
+            }
+        }
+    }
+    catch { /* 统计失败不阻断主流程 */ }
+    return { skeleton, total };
+}
 /**
  * v8.3.234+: 生成并落盘「功能单元分析质量报告」——成功/失败清单 + 每单元产出物评分。
  * 落盘到 020-specs/QUALITY_AUDIT.md；无可评单元时返回 null。