speccore 8.3.280 → 8.3.282

package/dist/commands/execute.js

@@ -576,6 +576,8 @@ async function executeWithProgress(tasks, iteration, base, skip, options) {
         logger_1.logger.info(agentCtx);
         logger_1.logger.info('--- AGENT CONTEXT END ---');
         logger_1.logger.info('\n💡 复制以上内容粘贴到 ' + options.agent + ' 中即可生成代码');
+        // v8.3.281+: 指路真正的自动派单——--agent 只打包上下文，Qoder 环境自动执行走 execute 主流程
+        logger_1.logger.info('   ⚡ 自动执行: 由宿主 AI 以子进程方式调用 speccore execute --prompt（非 TTY）时，CLI 自动通过 Qoder SDK 派子 Agent 执行并落盘，无需复制粘贴');
         (0, operation_log_1.logOperation)('speccore execute --agent', options.agent);
         return;
     }
@@ -1781,14 +1783,31 @@ function buildAgentContext(tasks, agent) {
     ctx += `→ Know what rules, APIs, services exist\n\n`;
     // 2. Per-task context
     for (const task of tasks) {
+        // v8.3.281+: 真实路径优先（scanTasks 记录的 path），AI 不再从 Iteration-* 通配符猜目录；
+        // 子任务向上两级即 Task-xxx/（00-specs、_shared 所在）
+        const subtaskDir = task.path || '';
+        const isSubtask = !!(task.parentTaskId && subtaskDir);
+        const taskRoot = isSubtask ? (0, path_1.join)(subtaskDir, '..', '..') : subtaskDir;
         ctx += `### Task: ${task.id} — ${task.name || task.id}\n`;
+        if (task.feature)
+            ctx += `功能单元: ${task.feature}（对齐锚点，对应 020-specs/${task.feature}/ 规格源）\n`;
         ctx += `Status: ${task.status} | Priority: ${task.priority} | Type: ${task.type}\n\n`;
         // Progressive loading order
         ctx += `**Read in this order (progressive disclosure):**\n`;
-        ctx += `1. \`Iteration-*/${task.id}/{platform}/{subtask}/TASK.md\` — 子任务概览（所有端平铺）\n`;
-        ctx += `2. \`Iteration-*/${task.id}/00-specs/REQ.md\` — 需求 + 验收标准\n`;
-        ctx += `3. \`Iteration-*/${task.id}/00-specs/TECH.md\` — 技术设计\n`;
-        ctx += `4. \`Iteration-*/${task.id}/_shared/API_CONTRACT.yaml\` — API 契约 (if exists)\n\n`;
+        if (taskRoot) {
+            const taskMdPath = isSubtask ? (0, path_1.join)(subtaskDir, 'TASK.md') : (0, path_1.join)(taskRoot, '_shared', 'TASK.md');
+            ctx += `1. \`${taskMdPath}\` — 子任务概览（所有端平铺）\n`;
+            ctx += `2. \`${(0, path_1.join)(taskRoot, '00-specs', 'REQ.md')}\` — 需求 + 验收标准\n`;
+            ctx += `3. \`${(0, path_1.join)(taskRoot, '00-specs', 'TECH.md')}\` — 技术设计\n`;
+            ctx += `4. \`${(0, path_1.join)(taskRoot, '_shared', 'API_CONTRACT.yaml')}\` — API 契约 (if exists)\n`;
+            ctx += `5. \`${(0, path_1.join)(subtaskDir, 'REQ.md')}\` / \`${(0, path_1.join)(subtaskDir, 'TECH.md')}\` — 本端子任务规格（骨架，待 Step 2.5 覆盖）\n\n`;
+        }
+        else {
+            ctx += `1. \`Iteration-*/${task.id}/{platform}/{subtask}/TASK.md\` — 子任务概览（所有端平铺）\n`;
+            ctx += `2. \`Iteration-*/${task.id}/00-specs/REQ.md\` — 需求 + 验收标准\n`;
+            ctx += `3. \`Iteration-*/${task.id}/00-specs/TECH.md\` — 技术设计\n`;
+            ctx += `4. \`Iteration-*/${task.id}/_shared/API_CONTRACT.yaml\` — API 契约 (if exists)\n\n`;
+        }
         ctx += `**Supplementary (read only if needed):**\n`;
         ctx += `- 子任务目录/TEST.md (测试用例) | 子任务目录/REVIEW.md (评审清单)\n`;
         ctx += `- 00-specs/SCHEMA.md (DB schema) | 子任务目录/ADR.md (架构决策)\n`;
@@ -1804,6 +1823,7 @@ function buildAgentContext(tasks, agent) {
     ctx += `- [ ] 已阅读 00-specs/REQ.md，理解需求和验收标准\n`;
     ctx += `- [ ] 已阅读 00-specs/TECH.md，理解技术方案\n`;
     ctx += `- [ ] 用 Write 覆盖本端子任务目录下预建的 REQ.md/TECH.md 骨架（含 SKELETON_MARKER 标记的文件），写出本端的专业规格，不得遗留骨架占位符\n`;
+    ctx += `- [ ] 前端端覆盖 STATE.md/ROUTES.md/COMPONENT_TREE.md/STYLE_GUIDE.md 骨架（含 _待AI分析_ 占位或 AI-FILL 注释的文件），按实际设计填充状态结构/路由表/组件树/样式指南（v8.3.282+）\n`;
     ctx += `- [ ] 代码实现严格遵循 REQ.md 的验收标准和 TECH.md 的技术方案\n`;
     ctx += `- [ ] 如涉及 API 变更，确保前后端接口签名一致\n`;
     ctx += `- [ ] 完成后更新 TASK.md 状态（doing → done）\n\n`;
@@ -2480,6 +2500,9 @@ async function runPromptMode(iteration, options) {
             return;
         logger_1.logger.warn('⚠️ [llm] 自配 LLM 未生成代码，回退宿主模式');
     }
+    // v8.3.281+: SDK 派单降级原因记录——此前仅 warn 到 stderr，外层 AI 主读 stdout 看不到，
+    // 误以为派单成功，导致 prompt 无人消费（exitCode 10 死锁）。现将原因上主通道。
+    let sdkFallbackReason = null;
     // v8.3.169+: 尝试通过 Qoder SDK 直接调度子 Agent（Qoder 环境且非 TTY 模式）
     if (!process.stdout.isTTY) {
         try {
@@ -2523,20 +2546,38 @@ async function runPromptMode(iteration, options) {
                 process.exitCode = 0;
                 return;
             }
+            if (!dispatchResult) {
+                // dispatchSubagent 返回 null：非 Qoder 宿主 / SDK 依赖缺失 / 鉴权未配置
+                sdkFallbackReason = 'Qoder SDK 直连通道不可用（非 Qoder 宿主 / SDK 依赖缺失 / 鉴权未配置），已降级为标记模式';
+            }
+            else {
+                sdkFallbackReason = dispatchResult.error
+                    ? `子 Agent 执行失败: ${dispatchResult.error}`
+                    : '子 Agent 执行失败（原因见上方日志），已降级为标记模式';
+            }
             // 宿主 SDK 调度失败（success=false）→ auto 时回退自配 LLM
             if (aiProvider === 'auto' && await tryLlmExecute())
                 return;
         }
         catch (e) {
             logger_1.logger.debug(`[execute] SDK 调度尝试失败: ${e.message}`);
+            sdkFallbackReason = `SDK 调度异常: ${e.message}`;
             // 宿主异常 → auto 时回退自配 LLM
             if (aiProvider === 'auto' && await tryLlmExecute())
                 return;
         }
     }
+    else {
+        sdkFallbackReason = '终端交互模式（TTY）：SDK 自动派单仅在宿主 AI 子进程调用（非 TTY）时触发，建议由 AI 助手代为执行本命令';
+    }
     // 输出到 stdout（Skill 通过 execute_command 捕获）
     // v8.3.166+: 在 prompt 前输出 subagent 标记
+    // v8.3.281+: 降级原因上主通道，外层 AI 必读，防止 prompt 无人消费的 exitCode 10 死锁
+    const fallbackHeader = sdkFallbackReason
+        ? `[SPECCORE_SDK_FALLBACK] ${sdkFallbackReason}\n→ 请按下方 prompt 生成代码，完成后用 speccore execute --apply / --response 落盘\n\n`
+        : '';
     const finalOutput = [
+        fallbackHeader,
         `[SPECCORE_SESSION_AGENT: ${platformSubagent}]`,
         `[SPECCORE_CONTEXT_BUDGET: 12000]`,
         `[SPECCORE_CONTEXT_TYPE: ${options.platform ? 'platform-only' : 'full'}]`,