@winspan/claude-forge 3.6.11 → 3.6.13

package/dist/pipeline/artifact-orchestrator.js

@@ -0,0 +1,110 @@
+import fs from 'fs';
+import path from 'path';
+import { logger } from '../utils/logger.js';
+/**
+ * ArtifactOrchestrator — 产物生成编排器（智能编排 2.0）
+ *
+ * 核心职责：根据 IntentAnalysis.artifactRequirements 生成文档产物，
+ * 完全独立于 Pipeline 生命周期，在 Stop 事件触发。
+ */
+export class ArtifactOrchestrator {
+    api;
+    storage;
+    constructor(api, storage) {
+        this.api = api;
+        this.storage = storage;
+    }
+    /**
+     * 根据意图分析结果生成文档产物（Stop 事件触发）
+     */
+    async generateArtifacts(projectPath, sessionId, analysis) {
+        const req = analysis.artifactRequirements;
+        if (!req?.needsDocumentArtifact)
+            return;
+        if (!req.suggestedArtifacts || req.suggestedArtifacts.length === 0)
+            return;
+        const docArtifacts = req.suggestedArtifacts.filter(a => a.type === 'document');
+        if (docArtifacts.length === 0)
+            return;
+        logger.info(`[产物编排] 开始生成 ${docArtifacts.length} 个文档产物（strategy=${req.persistenceStrategy}）`);
+        for (const artifact of docArtifacts) {
+            try {
+                await this.generateDocumentArtifact(projectPath, sessionId, artifact, analysis);
+            }
+            catch (err) {
+                logger.warn(`[产物编排] 生成 ${artifact.filename} 失败：${err}`);
+            }
+        }
+    }
+    async generateDocumentArtifact(projectPath, sessionId, artifact, analysis) {
+        // 解析目录（替换 YYYY-MM-DD 占位符）
+        const today = new Date().toISOString().slice(0, 10);
+        const resolvedDir = artifact.directory.replace(/YYYY-MM-DD/g, today);
+        const fullDir = path.join(projectPath, resolvedDir);
+        const fullPath = path.join(fullDir, artifact.filename);
+        // 幂等：已存在则跳过
+        if (fs.existsSync(fullPath)) {
+            logger.info(`[产物编排] 已存在，跳过：${resolvedDir}${artifact.filename}`);
+            return;
+        }
+        // 获取会话事件摘要
+        const eventSummary = this.buildEventSummary(sessionId, projectPath);
+        const prompt = this.buildGenerationPrompt(artifact, analysis, eventSummary, today);
+        const content = await this.api.complete(prompt, 'artifact');
+        // 确保目录存在
+        fs.mkdirSync(fullDir, { recursive: true });
+        fs.writeFileSync(fullPath, content, 'utf-8');
+        logger.info(`[产物编排] 已生成：${resolvedDir}${artifact.filename}`);
+    }
+    buildEventSummary(sessionId, projectPath) {
+        try {
+            const events = this.storage.queryEvents({
+                session_id: sessionId,
+                project_path: projectPath,
+                limit: 100,
+            });
+            const toolCalls = events
+                .filter(e => e.hook_type === 'PostToolUse' && e.tool_name)
+                .map(e => e.tool_name)
+                .filter(Boolean);
+            const userPrompts = events
+                .filter(e => e.hook_type === 'UserPromptSubmit' && e.tool_input)
+                .map(e => e.tool_input?.user_prompt?.slice(0, 200))
+                .filter(Boolean);
+            const parts = [];
+            if (userPrompts.length > 0) {
+                parts.push(`用户需求：${userPrompts.slice(0, 3).join(' / ')}`);
+            }
+            if (toolCalls.length > 0) {
+                const unique = [...new Set(toolCalls)];
+                parts.push(`工具调用：${unique.slice(0, 10).join(', ')}`);
+            }
+            return parts.join('\n') || '（无会话摘要）';
+        }
+        catch {
+            return '（会话摘要获取失败）';
+        }
+    }
+    buildGenerationPrompt(artifact, analysis, eventSummary, today) {
+        return `你是一个技术文档生成专家。请根据以下信息生成 ${artifact.filename}。
+
+## 任务信息
+- 任务类型：${analysis.taskType ?? 'unknown'}
+- 用户需求：${analysis.requirement}
+- 生成原因：${artifact.reason}
+- 文档日期：${today}
+
+## 本次会话摘要
+${eventSummary}
+
+## 要求
+请生成完整的 Markdown 文档，包含：
+1. 标题和日期
+2. 执行摘要（2-3 句话）
+3. 详细内容（根据任务类型展开）
+4. 结论和建议
+
+只输出 Markdown 内容，不要其他说明。`;
+    }
+}
+//# sourceMappingURL=artifact-orchestrator.js.map

package/dist/pipeline/artifact-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-orchestrator.js","sourceRoot":"","sources":["../../src/pipeline/artifact-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/execution-plan.d.ts

@@ -1,5 +1,5 @@
 import type { ArtifactConstraint } from '../convention/types.js';
-import type { IntentAnalysis } from '../goal/goal-types.js';
+import type { IntentAnalysis, TaskType } from '../goal/goal-types.js';
 import type { PipelinePhase, PipelineTemplate, PipelineTask, TemplateRouteResult } from './types.js';
 export type ExecutionPlanSource = 'template' | 'decompose';
 export interface CompletionPolicy {
@@ -28,7 +28,7 @@ export interface CanonicalExecutionPlan {
     projectPath: string;
     sessionId: string;
     complexity: 'simple' | 'moderate' | 'complex';
-    taskType: 'bugfix' | 'feature' | 'refactor' | 'performance' | 'documentation' | 'other';
+    taskType: TaskType;
     techStack?: string;
     reasoning?: string;
     templateId?: string;

package/dist/pipeline/execution-plan.d.ts.map

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

package/dist/pipeline/types.d.ts

@@ -1,4 +1,5 @@
 import type { PipelinePhase as CorePipelinePhase } from '../types/core-types.js';
+import type { TaskType } from '../goal/goal-types.js';
 export type { PipelinePhase } from '../types/core-types.js';
 export { PHASE_ORDER, PHASE_LABELS, nextPhase } from '../types/core-types.js';
 type PipelinePhase = CorePipelinePhase;
@@ -22,7 +23,7 @@ export interface Pipeline {
     tasks: PipelineTask[];
     techStack?: string;
     complexity?: 'simple' | 'moderate' | 'complex';
-    taskType?: 'bugfix' | 'feature' | 'refactor' | 'performance' | 'documentation' | 'other';
+    taskType?: TaskType;
     plannedPhases?: PipelinePhase[];
     phaseArtifacts?: Record<string, string[]>;
     reasoning?: string;
@@ -63,7 +64,7 @@ export interface PipelineTemplate {
     /** 来源规范名称（如 "BMad 敏捷开发规范"、"Harness 安全重构规范"），供透明度展示 */
     conventionName?: string;
     /** 任务类型（影响质量门禁策略） */
-    taskType?: 'bugfix' | 'feature' | 'refactor' | 'performance' | 'documentation' | 'other';
+    taskType?: TaskType;
     /** 触发条件 */
     trigger: {
         /** 自然语言意图描述列表，AI 用于语义匹配 */

package/dist/pipeline/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAG9E,KAAK,aAAa,GAAG,iBAAiB,CAAC;AAGvC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;IAErE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,WAAW;AACX,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;AAE/D,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW;IACX,OAAO,EAAE;QACP,2BAA2B;QAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,iBAAiB;QACjB,UAAU,EAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC,CAAC;QACrD,kBAAkB;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,WAAW;IACX,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,eAAe;IACf,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC;CACvC"}

package/dist/pipeline/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/prompts/intent-analysis.md

@@ -1,4 +1,4 @@
-你是一个 SDLC 意图分析引擎。请根据用户需求和项目实际情况，判断这个任务的复杂度和是否需要 Pipeline 编排。
+你是一个 SDLC 意图分析专家。请深度理解用户需求，从多个维度评估任务特征，动态决定编排策略和产物需求。
 
 ## 用户输入
 {{userPrompt}}
@@ -9,66 +9,127 @@
 {{projectStructureSection}}
 {{contextInfoSection}}
 
+---
+
+## 分析维度（多维度评估，不依赖单一文件数量）
+
+### 1. 任务类型识别
+- **feature**：新功能开发（需要设计+实现+测试）
+- **bugfix**：Bug 修复（定位+修复+验证）
+- **refactor**：代码重构（不改变行为，改善结构）
+- **optimize**：性能/安全/质量优化
+- **review**：代码/架构/系统评审（输出分析报告）
+- **audit**：安全/合规/质量审计（输出审计报告）
+- **config**：配置管理（环境/依赖/参数调整）
+- **deploy**：部署/CI/基础设施
+- **doc**：文档编写/更新
+- **test**：测试补充/覆盖率提升
+- **other**：其他
+
+### 2. 改动复杂度评估（多因子）
+- **文件数量**：1-2 / 3-5 / 6-10 / 10+
+- **模块耦合度**：single（单模块）/ cross-module（跨模块）/ cross-system（跨系统）
+- **业务影响面**：local（局部）/ module（模块级）/ system（系统级）
+- **技术风险**：low（配置/文档）/ medium（逻辑改动）/ high（架构/数据迁移）
+- **回滚难度**：easy（可逆）/ medium（需备份）/ hard（不可逆）
+
+### 3. 产物需求判断
+- **分析/评审/报告类任务**（review/audit）→ needsDocumentArtifact=true，persistenceStrategy=docs-directory
+- **代码改动类任务**（feature/bugfix/refactor）→ needsDocumentArtifact=false，persistenceStrategy=git-commit
+- **文档类任务**（doc）→ needsDocumentArtifact=true，persistenceStrategy=docs-directory
+- **混合类任务**（如"重构并写设计文档"）→ persistenceStrategy=both
+
+产物目录规范：
+- 评审报告 → `docs/YYYY-MM-DD/评审报告/`
+- 架构设计 → `docs/YYYY-MM-DD/架构设计/`
+- 测试报告 → `docs/YYYY-MM-DD/测试验证/`
+- 复盘报告 → `docs/YYYY-MM-DD/复盘/`
+
+### 4. Pipeline 编排决策
+**需要 Pipeline（requiresPipeline=true）的条件：**
+- 需求模糊，需要先 analyze 阶段梳理
+- 涉及多模块架构级改动，需要 design 阶段规划
+- 改动量大（10+ 文件）且需要任务拆分
+- 新功能开发需要完整质量管控流程
+
+**不需要 Pipeline（requiresPipeline=false）的条件：**
+- 一次性分析/评审任务（review/audit）→ 直接生成报告
+- 问题定位明确的 bugfix/optimize → 直接修复
+- 配置/文档类任务 → 直接执行
+- 执行已有规划 → 跳过分析阶段
+
+---
+
 ## 判断逻辑（按优先级）
 
-0. **是否是执行已有规划的指令？**（优先级最高）
-   - 如果用户说"按照规划进行"、"根据方案实施"、"执行计划"、"按照你的设计"等
-   - 且 {{planSection}} 显示存在活跃计划（有进行中或待处理任务）
-   - → moderate，requiresPipeline=false，suggestedPhases=["code","test"]，skipPhases=["analyze","design"]
-   - reasoning 中明确说明：检测到执行已有规划的意图，跳过前期分析阶段
-
-1. **这个需求是否涉及代码改动？**
-   - 不涉及（纯对话、提问、查看、运行命令）→ simple
-   - 涉及 → 继续判断
-
-2. **改动范围有多大？**（结合项目结构推断）
-   - 改 1-2 个文件，逻辑清晰 → simple，不需要编排
-   - 改 3-5 个文件，改动模式明确，问题定位清晰 → moderate，不需要编排
-   - 改动 6+ 个文件，或需求模糊需要先拆分 → complex，需要编排
-
-3. **是否需要 Pipeline 编排？**（仅在以下情况启用）
-   - 需求非常模糊，需要先 analyze 阶段梳理
-   - 涉及多个模块的架构级改动，需要 design 阶段规划
-   - 改动量大（10+ 文件）且需要任务拆分
-   - 新功能开发需要完整的质量管控流程
-
-## 重要原则
-- **优化/修复类任务**：即使涉及多个文件，只要问题定位明确、改动模式清晰，应判定为 moderate，不启动 Pipeline
-- **Bug 修复**：除非涉及架构级重构，否则都是 simple 或 moderate
-- **配置调整**：即使涉及多个配置文件，也是 moderate
-- **代码审查/优化**：如果是针对现有代码的优化，不是新功能开发，应判定为 moderate
+0. **执行已有规划？**（最高优先级）
+   - 用户说"按照规划"、"根据方案"、"执行计划"等
+   - 且 planSection 显示存在活跃计划
+   - → moderate，requiresPipeline=false，skipPhases=["analyze","design"]
+
+1. **分析/评审/报告类任务？**
+   - taskType=review 或 audit
+   - → moderate，requiresPipeline=false，needsDocumentArtifact=true
+   - 直接生成报告，不需要 Pipeline 编排
+
+2. **改动范围评估**
+   - 1-2 文件 + 低风险 → simple，requiresPipeline=false
+   - 3-5 文件 + 中等风险 → moderate，requiresPipeline=false
+   - 6+ 文件 或 高风险 或 跨系统 → complex，requiresPipeline=true
+
+---
 
 ## 输出格式（严格 JSON）
 {
+  "taskType": "feature|bugfix|refactor|optimize|review|audit|config|deploy|doc|test|other",
   "complexity": "simple|moderate|complex",
   "requiresPipeline": true/false,
+  "pipelineReason": "为什么需要或不需要 Pipeline（必填）",
   "requirement": "提炼后的一句话需求",
-  "reasoning": "判断理由：为什么是这个复杂度，预估改动哪些文件/模块，为什么需要或不需要编排",
+  "reasoning": "综合判断理由（包含任务类型、改动范围、产物需求的分析）",
   "estimatedFiles": 预估改动文件数(数字),
+
+  "changeScope": {
+    "estimatedFiles": 数字,
+    "moduleCoupling": "single|cross-module|cross-system",
+    "businessImpact": "local|module|system",
+    "technicalRisk": "low|medium|high",
+    "rollbackDifficulty": "easy|medium|hard"
+  },
+
+  "artifactRequirements": {
+    "needsDocumentArtifact": true/false,
+    "artifactTypes": ["code", "document", "config", "data"],
+    "persistenceStrategy": "git-commit|docs-directory|both",
+    "suggestedArtifacts": [
+      {
+        "type": "document",
+        "filename": "review-report.md",
+        "directory": "docs/YYYY-MM-DD/评审报告/",
+        "reason": "评审任务需要生成报告文档"
+      }
+    ]
+  },
+
+  "orchestrationStrategy": {
+    "suggestedPhases": ["analyze", "design", "code", "test", "review"],
+    "skipPhases": [],
+    "phaseReasoning": "为什么建议这些阶段",
+    "qualityGates": ["code-review", "test-coverage"]
+  },
+
   "suggestedPhases": ["analyze", "design", "code", "test", "review"],
   "skipPhases": [],
   "clarifyQuestions": ["需要向用户确认的问题（当需求不明确时）"],
   "searchKeywords": ["相关最佳实践关键词"],
-  "confidence": 0.0-1.0 置信度（必填）
+  "confidence": 0.0-1.0
 }
 
 注意：
 - simple 时 suggestedPhases 为空数组，requiresPipeline 为 false
-- moderate 时 requiresPipeline 为 false，suggestedPhases 可包含 code/test
+- moderate 时 requiresPipeline 通常为 false（除非需求模糊）
 - complex 时 requiresPipeline 为 true，suggestedPhases 包含完整流程
-- skipPhases 触发条件：
-  * 用户明确表达"按照规划"、"根据方案"、"执行计划"等执行意图
-  * 且存在活跃计划（planSection 显示有进行中或待处理任务）
-  * 此时设置 skipPhases=["analyze","design"]，直接进入实施阶段
-  * 不满足以上条件时，skipPhases 为空数组 []
-- clarifyQuestions 触发条件（满足任一即必须填写）：
-  * 需求中有歧义词（"优化"、"改进"、"处理"、"搞一下"等，没有明确目标）
-  * 涉及多个可能的实现方案，需要用户选择
-  * 缺少关键信息（如目标文件、功能范围、技术选型）
-  * 不满足以上条件时，clarifyQuestions 为空数组 []
-- confidence 置信度评估标准：
-  * 0.8-1.0: 需求明确，改动范围清晰，有充分上下文支持
-  * 0.6-0.8: 需求基本明确，但缺少部分细节或上下文
-  * 0.4-0.6: 需求模糊，存在多种理解可能，建议主动澄清
-  * 0.0-0.4: 需求严重不明确，必须澄清后才能继续
+- review/audit 类任务：requiresPipeline=false，needsDocumentArtifact=true
+- suggestedArtifacts 中的 directory 使用实际日期替换 YYYY-MM-DD
+- confidence 评估：0.8-1.0 需求明确 / 0.6-0.8 基本明确 / 0.4-0.6 模糊需澄清 / 0.0-0.4 严重不明确
 - 只输出 JSON，不要其他内容