@winspan/claude-forge 0.1.1

package/dist/pattern-engine/pattern-executor.js

@@ -0,0 +1,185 @@
+import { randomUUID } from 'crypto';
+import { logger } from '../utils/logger.js';
+/**
+ * 将 Mustache 风格的 {{key}} 占位符替换为 context 中的对应值。
+ * 未找到的 key 保留原始占位符。
+ */
+function renderTemplate(template, context) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+        return context[key] ?? `{{${key}}}`;
+    });
+}
+/**
+ * 按 depends_on 拓扑排序，返回无依赖冲突的执行顺序。
+ * 找到的第一个可执行阶段（所有依赖均已 completed）视为 currentPhaseId。
+ */
+function findNextPhase(plan, pattern) {
+    for (const phase of pattern.phases) {
+        if (plan.phases[phase.id] !== 'pending')
+            continue;
+        const allDepsCompleted = phase.depends_on.every((dep) => plan.phases[dep] === 'completed');
+        if (allDepsCompleted)
+            return phase.id;
+    }
+    return null;
+}
+/**
+ * PatternExecutor：将匹配到的 Pattern 展开为 ExecutionPlan，
+ * 渲染当前阶段的 prompt_template，生成注入给 Claude 的 additionalContext。
+ *
+ * 职责边界：
+ * - 创建和管理内存中的 ExecutionPlan（持久化由 ExecutionTracer 负责）
+ * - 模板渲染
+ * - 生成 PatternContext 供 UserPromptHandler 注入
+ *
+ * 不负责：AI 调用、SQLite 写入、状态机推进
+ */
+export class PatternExecutor {
+    /** 按 projectPath 存储当前活跃的执行计划（每个项目同时只有一个） */
+    activePlans = new Map();
+    /**
+     * 为指定项目启动一个新的执行计划。
+     * 若该项目已有活跃计划，先清除（不支持并发 Pattern 执行）。
+     */
+    startPlan(pattern, sessionId, projectPath) {
+        const phases = {};
+        for (const phase of pattern.phases) {
+            phases[phase.id] = 'pending';
+        }
+        const plan = {
+            id: randomUUID(),
+            patternId: pattern.id,
+            sessionId,
+            projectPath,
+            phases,
+            currentPhaseId: null,
+            context: { requirement: '' }, // 将在 execute() 中填充
+            startedAt: new Date().toISOString(),
+        };
+        // 找到第一个可以执行的阶段
+        plan.currentPhaseId = findNextPhase(plan, pattern);
+        if (plan.currentPhaseId) {
+            plan.phases[plan.currentPhaseId] = 'running';
+        }
+        this.activePlans.set(projectPath, plan);
+        logger.info(`[Forge:执行器] 新计划 id=${plan.id} | pattern=${pattern.id} | 当前阶段=${plan.currentPhaseId ?? '无'}`);
+        return plan;
+    }
+    /**
+     * 生成当前活跃阶段的 PatternContext（含渲染后的 prompt）。
+     * 返回 null 表示无活跃计划或当前阶段已执行完毕。
+     */
+    execute(pattern, plan, requirement) {
+        if (!plan.currentPhaseId) {
+            logger.info(`[Forge:执行器] 计划 ${plan.id} 无可执行阶段`);
+            return null;
+        }
+        const phase = pattern.phases.find((p) => p.id === plan.currentPhaseId);
+        if (!phase) {
+            logger.warn(`[Forge:执行器] 找不到阶段 ${plan.currentPhaseId}`);
+            return null;
+        }
+        // 将 requirement 注入上下文后渲染模板
+        const context = { ...plan.context, requirement };
+        const phasePrompt = renderTemplate(phase.prompt_template, context);
+        return {
+            phasePrompt,
+            planId: plan.id,
+            currentPhaseId: plan.currentPhaseId,
+            patternName: pattern.name,
+        };
+    }
+    /**
+     * 将指定阶段标记为已完成，并推进到下一个可执行阶段。
+     * 供 ExecutionTracer 在检测到 completion_signal 时调用。
+     *
+     * @returns 下一个阶段 ID，null 表示整个 Pattern 已执行完毕
+     */
+    advancePhase(projectPath, completedPhaseId, phaseOutput, pattern) {
+        const plan = this.activePlans.get(projectPath);
+        if (!plan)
+            return null;
+        // 标记阶段完成
+        plan.phases[completedPhaseId] = 'completed';
+        // 如果该阶段有 output_key，写入执行上下文供后续阶段模板使用
+        const phase = pattern.phases.find((p) => p.id === completedPhaseId);
+        if (phase?.output_key) {
+            plan.context[phase.output_key] = phaseOutput;
+        }
+        // 找下一个可执行阶段
+        const nextPhaseId = findNextPhase(plan, pattern);
+        plan.currentPhaseId = nextPhaseId;
+        if (nextPhaseId) {
+            plan.phases[nextPhaseId] = 'running';
+            logger.info(`[Forge:执行器] 阶段推进：${completedPhaseId} → ${nextPhaseId}`);
+        }
+        else {
+            plan.completedAt = new Date().toISOString();
+            logger.info(`[Forge:执行器] Pattern ${plan.patternId} 全部阶段完成`);
+        }
+        return nextPhaseId;
+    }
+    /** 获取项目当前活跃计划（不存在则返回 null） */
+    getActivePlan(projectPath) {
+        return this.activePlans.get(projectPath) ?? null;
+    }
+    /** 清除项目的活跃计划（Pattern 完成或被中断时调用） */
+    clearPlan(projectPath) {
+        this.activePlans.delete(projectPath);
+        logger.info(`[Forge:执行器] 清除项目 ${projectPath} 的执行计划`);
+    }
+    /** 构建注入给 Claude 的 additionalContext 字符串，可选传入 Convention 以注入角色约束 */
+    buildAdditionalContext(patternCtx, pattern, convention) {
+        const currentPhase = pattern.phases.find((p) => p.id === patternCtx.currentPhaseId);
+        if (!currentPhase)
+            return patternCtx.phasePrompt;
+        const phaseIndex = pattern.phases.indexOf(currentPhase) + 1;
+        const totalPhases = pattern.phases.length;
+        const toolsHint = currentPhase.tools_allowed.length > 0
+            ? `\n可用工具：${currentPhase.tools_allowed.join('、')}`
+            : '';
+        // 从 Convention 查找当前角色的约束定义
+        let roleConstraint = '';
+        if (convention?.roles) {
+            const roleDef = convention.roles[currentPhase.agent_role];
+            if (roleDef) {
+                roleConstraint = [
+                    '',
+                    `## 角色规范约束（来自 ${convention.name} v${convention.version}）`,
+                    `职责：${roleDef.responsibilities.trim()}`,
+                    `约束：${roleDef.constraints.trim()}`,
+                ].join('\n');
+            }
+        }
+        return [
+            `【Pattern 编排】${patternCtx.patternName} — 第 ${phaseIndex}/${totalPhases} 阶段：${currentPhase.name}`,
+            `角色：${currentPhase.agent_role}${toolsHint}`,
+            '',
+            patternCtx.phasePrompt,
+            roleConstraint,
+        ].join('\n');
+    }
+    /** 检测 PostToolUse 事件是否触发了当前阶段的 completion_signal */
+    checkCompletionSignal(projectPath, toolName, toolInput, pattern) {
+        const plan = this.activePlans.get(projectPath);
+        if (!plan?.currentPhaseId)
+            return false;
+        const phase = pattern.phases.find((p) => p.id === plan.currentPhaseId);
+        if (!phase?.completion_signal)
+            return false;
+        const signal = phase.completion_signal;
+        if (signal.tool_used && toolName !== signal.tool_used)
+            return false;
+        if (signal.file_pattern) {
+            const filePath = String(toolInput['file_path'] ?? toolInput['path'] ?? '');
+            if (!filePath)
+                return false;
+            // 简单 glob 匹配（仅支持 * 通配符）
+            const regex = new RegExp('^' + signal.file_pattern.replace(/\./g, '\\.').replace(/\*/g, '.*') + '$');
+            if (!regex.test(filePath.split('/').pop() ?? filePath))
+                return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=pattern-executor.js.map

package/dist/pattern-engine/pattern-executor.js.map

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

package/dist/pattern-engine/pattern-loader.d.ts

@@ -0,0 +1,14 @@
+import type { Pattern } from './types.js';
+export declare class PatternLoader {
+    private patternsDir;
+    constructor(patternsDir?: string);
+    /** 加载目录下所有 .yaml/.yml Pattern 文件 */
+    loadAll(): Pattern[];
+    /** 加载并验证单个 Pattern 文件 */
+    loadFile(filePath: string): Pattern | null;
+    /** 将 Pattern 写回 YAML 文件（供 PatternEvolver 调用） */
+    savePattern(pattern: Pattern): void;
+    /** 返回 patterns 目录路径 */
+    getPatternsDir(): string;
+}
+//# sourceMappingURL=pattern-loader.d.ts.map

package/dist/pattern-engine/pattern-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-loader.d.ts","sourceRoot":"","sources":["../../src/pattern-engine/pattern-loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAsD1C,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAAqB;IAI9C,oCAAoC;IACpC,OAAO,IAAI,OAAO,EAAE;IAuBpB,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAuB1C,gDAAgD;IAChD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAanC,uBAAuB;IACvB,cAAc,IAAI,MAAM;CAGzB"}

package/dist/pattern-engine/pattern-loader.js

@@ -0,0 +1,111 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import yaml from 'js-yaml';
+import { z } from 'zod';
+import { logger } from '../utils/logger.js';
+const PATTERNS_DIR = path.join(os.homedir(), '.claude-forge', 'patterns');
+// ── Zod 校验 Schema ──────────────────────────────────────────────────
+const CompletionSignalSchema = z.object({
+    tool_used: z.string().optional(),
+    file_pattern: z.string().optional(),
+});
+const PhaseGateSchema = z.object({
+    command: z.string(),
+    must_pass: z.boolean(),
+});
+const PatternPhaseSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    agent_role: z.string(),
+    prompt_template: z.string(),
+    tools_allowed: z.array(z.string()).default([]),
+    depends_on: z.array(z.string()).default([]),
+    output_key: z.string().optional(),
+    completion_signal: CompletionSignalSchema.optional(),
+    gate: PhaseGateSchema.optional(),
+    invoke_skill: z.string().optional(),
+});
+const PatternTriggerSchema = z.object({
+    intent_patterns: z.array(z.string()).min(1),
+    complexity: z.array(z.enum(['simple', 'moderate', 'complex'])).optional(),
+    keywords: z.array(z.string()).optional(),
+});
+const PatternEvolutionSchema = z.object({
+    track_metrics: z.array(z.string()).default([]),
+    auto_optimize: z.boolean().default(true),
+    optimize_interval_days: z.number().int().positive().default(7),
+});
+const PatternSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    version: z.string(),
+    description: z.string(),
+    source: z.enum(['official', 'user', 'generated']).default('user'),
+    trigger: PatternTriggerSchema,
+    phases: z.array(PatternPhaseSchema).min(1),
+    evolution: PatternEvolutionSchema.optional(),
+});
+// ── PatternLoader ────────────────────────────────────────────────────
+export class PatternLoader {
+    patternsDir;
+    constructor(patternsDir = PATTERNS_DIR) {
+        this.patternsDir = patternsDir;
+    }
+    /** 加载目录下所有 .yaml/.yml Pattern 文件 */
+    loadAll() {
+        if (!fs.existsSync(this.patternsDir)) {
+            logger.info(`[Pattern加载器] 目录不存在，跳过：${this.patternsDir}`);
+            return [];
+        }
+        const files = fs.readdirSync(this.patternsDir).filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'));
+        const patterns = [];
+        for (const file of files) {
+            const filePath = path.join(this.patternsDir, file);
+            const pattern = this.loadFile(filePath);
+            if (pattern) {
+                patterns.push(pattern);
+            }
+        }
+        logger.info(`[Pattern加载器] 已加载 ${patterns.length} 个 Pattern`);
+        return patterns;
+    }
+    /** 加载并验证单个 Pattern 文件 */
+    loadFile(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const raw = yaml.load(content);
+            const result = PatternSchema.safeParse(raw);
+            if (!result.success) {
+                logger.warn(`[Pattern加载器] 校验失败 ${filePath}：${result.error.message}`);
+                return null;
+            }
+            const pattern = {
+                ...result.data,
+                filePath,
+            };
+            return pattern;
+        }
+        catch (err) {
+            logger.warn(`[Pattern加载器] 解析失败 ${filePath}：${err}`);
+            return null;
+        }
+    }
+    /** 将 Pattern 写回 YAML 文件（供 PatternEvolver 调用） */
+    savePattern(pattern) {
+        if (!fs.existsSync(this.patternsDir)) {
+            fs.mkdirSync(this.patternsDir, { recursive: true });
+        }
+        const filePath = pattern.filePath || path.join(this.patternsDir, `${pattern.id}.yaml`);
+        // 序列化时去掉运行时字段
+        const { filePath: _fp, ...serializable } = pattern;
+        const content = yaml.dump(serializable, { lineWidth: 100, noRefs: true });
+        fs.writeFileSync(filePath, content, 'utf-8');
+        logger.info(`[Pattern加载器] 已保存 ${pattern.id} v${pattern.version}`);
+    }
+    /** 返回 patterns 目录路径 */
+    getPatternsDir() {
+        return this.patternsDir;
+    }
+}
+//# sourceMappingURL=pattern-loader.js.map

package/dist/pattern-engine/pattern-loader.js.map

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

package/dist/pattern-engine/pattern-router.d.ts

@@ -0,0 +1,24 @@
+import type { ClaudeAPI } from '../utils/claude-api.js';
+import type { Pattern, RouteResult } from './types.js';
+/**
+ * PatternRouter：用 AI 语义匹配将用户意图路由到合适的 Pattern。
+ * 2s 超时后自动降级到关键词匹配，保证响应速度。
+ */
+export declare class PatternRouter {
+    private api;
+    private patterns;
+    constructor(api: ClaudeAPI);
+    /** 更新可用 Pattern 列表（由 PatternEngine 调用） */
+    setPatterns(patterns: Pattern[]): void;
+    /**
+     * 路由入口：先尝试 AI 语义匹配，超时或失败则降级到关键词匹配。
+     * @param userInput 用户原始输入
+     * @param complexity 意图复杂度（由 IntentEngine 提供）
+     */
+    route(userInput: string, complexity?: 'simple' | 'moderate' | 'complex'): Promise<RouteResult>;
+    /** AI 语义匹配（2s 超时） */
+    private routeWithAI;
+    /** 关键词兜底匹配 */
+    private routeWithKeywords;
+}
+//# sourceMappingURL=pattern-router.d.ts.map

package/dist/pattern-engine/pattern-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-router.d.ts","sourceRoot":"","sources":["../../src/pattern-engine/pattern-router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIvD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,QAAQ,CAAiB;gBAErB,GAAG,EAAE,SAAS;IAI1B,0CAA0C;IAC1C,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAItC;;;;OAIG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAC7C,OAAO,CAAC,WAAW,CAAC;IAmBvB,qBAAqB;YACP,WAAW;IAuDzB,cAAc;IACd,OAAO,CAAC,iBAAiB;CAiD1B"}

package/dist/pattern-engine/pattern-router.js

@@ -0,0 +1,124 @@
+import { logger } from '../utils/logger.js';
+const ROUTE_TIMEOUT_MS = 60_000;
+/**
+ * PatternRouter：用 AI 语义匹配将用户意图路由到合适的 Pattern。
+ * 2s 超时后自动降级到关键词匹配，保证响应速度。
+ */
+export class PatternRouter {
+    api;
+    patterns = [];
+    constructor(api) {
+        this.api = api;
+    }
+    /** 更新可用 Pattern 列表（由 PatternEngine 调用） */
+    setPatterns(patterns) {
+        this.patterns = patterns;
+    }
+    /**
+     * 路由入口：先尝试 AI 语义匹配，超时或失败则降级到关键词匹配。
+     * @param userInput 用户原始输入
+     * @param complexity 意图复杂度（由 IntentEngine 提供）
+     */
+    async route(userInput, complexity) {
+        if (this.patterns.length === 0) {
+            return { pattern: null, confidence: 0, method: 'fallback' };
+        }
+        // 先尝试 AI 匹配（带超时）
+        try {
+            const aiResult = await this.routeWithAI(userInput, complexity);
+            if (aiResult.pattern) {
+                return aiResult;
+            }
+        }
+        catch (err) {
+            logger.info(`[Pattern路由器] AI 匹配失败，降级到关键词匹配：${err}`);
+        }
+        // 降级：关键词匹配
+        return this.routeWithKeywords(userInput, complexity);
+    }
+    /** AI 语义匹配（2s 超时） */
+    async routeWithAI(userInput, complexity) {
+        const patternList = this.patterns
+            .map((p) => `- id: ${p.id}\n  name: ${p.name}\n  description: ${p.description}\n  intent_patterns: ${p.trigger.intent_patterns.join(' / ')}`)
+            .join('\n');
+        const prompt = `你是一个任务路由专家，根据用户输入匹配最合适的工作流 Pattern。
+
+## 用户输入
+${userInput}
+${complexity ? `\n## 任务复杂度\n${complexity}` : ''}
+
+## 可用 Pattern 列表
+${patternList}
+
+## 任务
+选择最匹配的 Pattern。如果没有任何 Pattern 明显符合，输出 NONE。
+
+## 输出格式（严格 JSON，无其他文字）
+{ "id": "pattern-id", "confidence": 0.85 }
+或
+{ "id": "NONE", "confidence": 0 }`;
+        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('AI 路由超时')), ROUTE_TIMEOUT_MS));
+        const apiPromise = this.api.complete(prompt, 'pattern-router', 0, ROUTE_TIMEOUT_MS);
+        const response = await Promise.race([apiPromise, timeoutPromise]);
+        const jsonMatch = response.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            return { pattern: null, confidence: 0, method: 'ai' };
+        const parsed = JSON.parse(jsonMatch[0]);
+        if (parsed.id === 'NONE' || !parsed.id) {
+            return { pattern: null, confidence: 0, method: 'ai' };
+        }
+        const matched = this.patterns.find((p) => p.id === parsed.id);
+        if (!matched)
+            return { pattern: null, confidence: 0, method: 'ai' };
+        // 复杂度过滤：如果 Pattern 指定了复杂度范围，检查是否兼容
+        if (complexity && matched.trigger.complexity && matched.trigger.complexity.length > 0) {
+            if (!matched.trigger.complexity.includes(complexity)) {
+                logger.info(`[Pattern路由器] ${matched.id} 不适用于复杂度 ${complexity}，跳过`);
+                return { pattern: null, confidence: 0, method: 'ai' };
+            }
+        }
+        logger.info(`[Pattern路由器] AI 匹配：${matched.id}（置信度 ${parsed.confidence}）`);
+        return { pattern: matched, confidence: parsed.confidence, method: 'ai' };
+    }
+    /** 关键词兜底匹配 */
+    routeWithKeywords(userInput, complexity) {
+        const input = userInput.toLowerCase();
+        let bestMatch = null;
+        let bestScore = 0;
+        for (const pattern of this.patterns) {
+            // 复杂度过滤
+            if (complexity && pattern.trigger.complexity && pattern.trigger.complexity.length > 0) {
+                if (!pattern.trigger.complexity.includes(complexity)) {
+                    continue;
+                }
+            }
+            let score = 0;
+            const keywords = pattern.trigger.keywords ?? [];
+            for (const kw of keywords) {
+                if (input.includes(kw.toLowerCase())) {
+                    score++;
+                }
+            }
+            // intent_patterns 也做简单的词重叠
+            for (const intentPattern of pattern.trigger.intent_patterns) {
+                const words = intentPattern.split(/[\s，,、]+/).filter((w) => w.length > 1);
+                for (const word of words) {
+                    if (input.includes(word.toLowerCase())) {
+                        score += 0.5;
+                    }
+                }
+            }
+            if (score > bestScore) {
+                bestScore = score;
+                bestMatch = pattern;
+            }
+        }
+        const confidence = bestMatch ? Math.min(bestScore / 3, 1) : 0;
+        if (bestMatch && confidence >= 0.3) {
+            logger.info(`[Pattern路由器] 关键词匹配：${bestMatch.id}（得分 ${bestScore.toFixed(1)}）`);
+            return { pattern: bestMatch, confidence, method: 'keyword' };
+        }
+        return { pattern: null, confidence: 0, method: 'fallback' };
+    }
+}
+//# sourceMappingURL=pattern-router.js.map

package/dist/pattern-engine/pattern-router.js.map

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

package/dist/pattern-engine/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Pattern-Agent 编排系统类型定义
+ *
+ * Pattern 是有状态工作流的声明式描述，可配置、可进化、可自动触发。
+ * 每个 Pattern 由多个 Phase 组成，Phase 间支持依赖关系和质量门禁。
+ */
+export type PatternSource = 'official' | 'user' | 'generated';
+export type PhaseStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+export type PatternComplexity = 'simple' | 'moderate' | 'complex';
+/** Phase 完成信号：检测到指定工具调用时视为阶段完成 */
+export interface CompletionSignal {
+    /** 必须出现的工具名（如 Write、Edit） */
+    tool_used?: string;
+    /** 操作文件必须匹配的 glob 模式（如 "*.md"） */
+    file_pattern?: string;
+}
+/** Phase 质量门禁：必须通过才能进入下一阶段 */
+export interface PhaseGate {
+    /** 执行的命令，如 "npm test" */
+    command: string;
+    /** 是否必须通过（true = 失败则终止整个 Pattern） */
+    must_pass: boolean;
+}
+/** 单个执行阶段定义 */
+export interface PatternPhase {
+    /** 阶段唯一 ID，供 depends_on 引用 */
+    id: string;
+    /** 阶段显示名称 */
+    name: string;
+    /** Agent 角色标识，注入到 prompt_template 中 */
+    agent_role: string;
+    /** Mustache 模板，支持 {{变量}} 占位符 */
+    prompt_template: string;
+    /** 允许使用的工具列表（空数组 = 不限制） */
+    tools_allowed: string[];
+    /** 前置依赖阶段 ID 列表 */
+    depends_on: string[];
+    /** 本阶段输出存储到上下文的键名 */
+    output_key?: string;
+    /** 完成信号检测（可选，不配置则 AI 自行判断完成） */
+    completion_signal?: CompletionSignal;
+    /** 阶段完成后的质量门禁（可选） */
+    gate?: PhaseGate;
+    /** 是否允许调用已注册的 Skill */
+    invoke_skill?: string;
+}
+/** Pattern 触发条件 */
+export interface PatternTrigger {
+    /** 自然语言意图描述列表，AI 用于语义匹配 */
+    intent_patterns: string[];
+    /** 适用的意图复杂度范围 */
+    complexity?: PatternComplexity[];
+    /** 额外关键词（兜底匹配，不依赖 AI） */
+    keywords?: string[];
+}
+/** Pattern 自进化配置 */
+export interface PatternEvolution {
+    /** 记录哪些指标用于进化分析 */
+    track_metrics: string[];
+    /** 是否开启自动进化 */
+    auto_optimize: boolean;
+    /** 触发进化的最小执行间隔天数 */
+    optimize_interval_days: number;
+}
+/** Pattern 完整定义（对应 YAML 文件结构） */
+export interface Pattern {
+    /** 唯一标识符，文件名（不含 .yaml） */
+    id: string;
+    /** 显示名称 */
+    name: string;
+    /** 版本号（语义版本） */
+    version: string;
+    /** 描述，供 PatternRouter AI 匹配时参考 */
+    description: string;
+    /** 来源 */
+    source: PatternSource;
+    /** 触发条件 */
+    trigger: PatternTrigger;
+    /** 阶段列表（有序，但执行顺序由 depends_on 决定） */
+    phases: PatternPhase[];
+    /** 自进化配置（可选） */
+    evolution?: PatternEvolution;
+    /** YAML 文件路径（运行时填充，不在 YAML 中） */
+    filePath?: string;
+}
+/** 执行上下文：各阶段输出的累积 KV 存储 */
+export type ExecutionContext = Record<string, string>;
+/** 当前执行计划（展开 Pattern 后的运行时状态） */
+export interface ExecutionPlan {
+    /** 唯一执行 ID */
+    id: string;
+    /** 对应的 Pattern ID */
+    patternId: string;
+    /** 所属会话 */
+    sessionId: string;
+    /** 项目路径 */
+    projectPath: string;
+    /** 各阶段的执行状态 */
+    phases: Record<string, PhaseStatus>;
+    /** 当前活跃阶段 ID */
+    currentPhaseId: string | null;
+    /** 执行上下文（阶段间传递的输出） */
+    context: ExecutionContext;
+    /** 整体开始时间 */
+    startedAt: string;
+    /** 整体完成时间 */
+    completedAt?: string;
+}
+/** SQLite pattern_executions 表对应的记录类型 */
+export interface PatternExecution {
+    id: string;
+    pattern_id: string;
+    session_id: string;
+    project_path: string;
+    phase_id: string;
+    status: PhaseStatus;
+    started_at: string | null;
+    completed_at: string | null;
+    duration_ms: number | null;
+    output: string | null;
+    user_satisfaction: number | null;
+    created_at: string;
+}
+/** PatternRouter 的路由结果 */
+export interface RouteResult {
+    /** 匹配到的 Pattern（null = 未匹配，降级到 SkillOrchestrator） */
+    pattern: Pattern | null;
+    /** 匹配置信度 0-1 */
+    confidence: number;
+    /** 匹配方式 */
+    method: 'ai' | 'keyword' | 'fallback';
+}
+/** PatternExecutor 生成的 additionalContext 内容 */
+export interface PatternContext {
+    /** 当前活跃 Phase 的 prompt 模板渲染结果 */
+    phasePrompt: string;
+    /** 执行计划 ID（供 ExecutionTracer 关联） */
+    planId: string;
+    /** 当前 Phase ID */
+    currentPhaseId: string;
+    /** Pattern 名称（供日志） */
+    patternName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pattern-engine/types.d.ts.map

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