@winspan/claude-forge 0.1.1

package/dist/pattern-engine/execution-tracker.d.ts

@@ -0,0 +1,45 @@
+import type { ForgeEvent } from '../types/index.js';
+import type { SQLiteStorage } from '../storage/sqlite.js';
+import type { PatternExecution } from './types.js';
+import type { PatternExecutor } from './pattern-executor.js';
+import type { Pattern } from './types.js';
+/**
+ * ExecutionTracer：PostToolUse 状态机推进器。
+ *
+ * 职责：
+ * 1. 监听 PostToolUse 事件，检测当前阶段的 completion_signal
+ * 2. 将阶段执行记录写入 SQLite pattern_executions 表
+ * 3. 调用 PatternExecutor.advancePhase() 推进状态机
+ *
+ * 不负责：AI 调用、prompt 渲染、Pattern 路由
+ */
+export declare class ExecutionTracer {
+    private readonly storage;
+    private readonly executor;
+    /** 记录每个 planId+phaseId 的开始时间（毫秒时间戳） */
+    private phaseStartTimes;
+    constructor(storage: SQLiteStorage, executor: PatternExecutor);
+    /**
+     * 处理 PostToolUse 事件。
+     * 若当前项目有活跃 Pattern 计划且检测到 completion_signal，则推进阶段。
+     *
+     * @returns 推进后的下一阶段 ID，null 表示未推进或 Pattern 已完成
+     */
+    onPostToolUse(event: ForgeEvent, pattern: Pattern): Promise<string | null>;
+    /**
+     * 记录阶段开始（在 PatternExecutor.startPlan 后调用）。
+     */
+    recordPhaseStart(planId: string, phaseId: string, patternId: string, sessionId: string, projectPath: string): void;
+    /**
+     * 将执行记录写入 SQLite。
+     * 使用 INSERT OR REPLACE 以支持状态更新（running → completed）。
+     */
+    private writeExecution;
+    /**
+     * 查询指定 Pattern 的最近执行记录（供 PatternEvolver 使用）。
+     */
+    queryExecutions(patternId: string, limit?: number): PatternExecution[];
+    /** 更新用户满意度（+1 正向 / -1 负向 / 0 中性） */
+    updateSatisfaction(executionId: string, satisfaction: number): void;
+}
+//# sourceMappingURL=execution-tracker.d.ts.map

package/dist/pattern-engine/execution-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-tracker.d.ts","sourceRoot":"","sources":["../../src/pattern-engine/execution-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM1C;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,uCAAuC;IACvC,OAAO,CAAC,eAAe,CAA6B;gBAGjC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,eAAe;IAG5C;;;;;OAKG;IACG,aAAa,CACjB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiEzB;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAoBlH;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,gBAAgB,EAAE;IASlE,oCAAoC;IACpC,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;CAOpE"}

package/dist/pattern-engine/execution-tracker.js

@@ -0,0 +1,132 @@
+import { randomUUID } from 'crypto';
+import { logger } from '../utils/logger.js';
+import { truncateHead } from '../utils/truncate.js';
+const OUTPUT_MAX_CHARS = 500;
+/**
+ * ExecutionTracer：PostToolUse 状态机推进器。
+ *
+ * 职责：
+ * 1. 监听 PostToolUse 事件，检测当前阶段的 completion_signal
+ * 2. 将阶段执行记录写入 SQLite pattern_executions 表
+ * 3. 调用 PatternExecutor.advancePhase() 推进状态机
+ *
+ * 不负责：AI 调用、prompt 渲染、Pattern 路由
+ */
+export class ExecutionTracer {
+    storage;
+    executor;
+    /** 记录每个 planId+phaseId 的开始时间（毫秒时间戳） */
+    phaseStartTimes = new Map();
+    constructor(storage, executor) {
+        this.storage = storage;
+        this.executor = executor;
+    }
+    /**
+     * 处理 PostToolUse 事件。
+     * 若当前项目有活跃 Pattern 计划且检测到 completion_signal，则推进阶段。
+     *
+     * @returns 推进后的下一阶段 ID，null 表示未推进或 Pattern 已完成
+     */
+    async onPostToolUse(event, pattern) {
+        const plan = this.executor.getActivePlan(event.project_path);
+        if (!plan?.currentPhaseId)
+            return null;
+        const toolName = event.tool_name ?? '';
+        const toolInput = (event.tool_input ?? {});
+        const triggered = this.executor.checkCompletionSignal(event.project_path, toolName, toolInput, pattern);
+        if (!triggered)
+            return null;
+        const completedPhaseId = plan.currentPhaseId;
+        const startKey = `${plan.id}:${completedPhaseId}`;
+        const startedAt = this.phaseStartTimes.get(startKey);
+        const completedAt = new Date().toISOString();
+        const durationMs = startedAt ? Date.now() - startedAt : null;
+        // 提取阶段输出摘要（tool_output 截断到 500 字符）
+        const rawOutput = String(event.tool_output ?? '');
+        const output = truncateHead(rawOutput, OUTPUT_MAX_CHARS);
+        // 写入 SQLite
+        this.writeExecution({
+            id: randomUUID(),
+            pattern_id: pattern.id,
+            session_id: plan.sessionId,
+            project_path: event.project_path,
+            phase_id: completedPhaseId,
+            status: 'completed',
+            started_at: startedAt ? new Date(startedAt).toISOString() : null,
+            completed_at: completedAt,
+            duration_ms: durationMs,
+            output,
+            user_satisfaction: null,
+            created_at: new Date().toISOString(),
+        });
+        this.phaseStartTimes.delete(startKey);
+        // 推进状态机
+        const nextPhaseId = this.executor.advancePhase(event.project_path, completedPhaseId, output, pattern);
+        // 若有下一阶段，记录其开始时间
+        if (nextPhaseId) {
+            const nextKey = `${plan.id}:${nextPhaseId}`;
+            this.phaseStartTimes.set(nextKey, Date.now());
+            logger.info(`[Forge:追踪器] 阶段 ${completedPhaseId} 完成 → 推进到 ${nextPhaseId}`);
+        }
+        else {
+            logger.info(`[Forge:追踪器] Pattern ${pattern.id} 全部阶段完成`);
+            this.executor.clearPlan(event.project_path);
+        }
+        return nextPhaseId;
+    }
+    /**
+     * 记录阶段开始（在 PatternExecutor.startPlan 后调用）。
+     */
+    recordPhaseStart(planId, phaseId, patternId, sessionId, projectPath) {
+        const key = `${planId}:${phaseId}`;
+        this.phaseStartTimes.set(key, Date.now());
+        this.writeExecution({
+            id: randomUUID(),
+            pattern_id: patternId,
+            session_id: sessionId,
+            project_path: projectPath,
+            phase_id: phaseId,
+            status: 'running',
+            started_at: new Date().toISOString(),
+            completed_at: null,
+            duration_ms: null,
+            output: null,
+            user_satisfaction: null,
+            created_at: new Date().toISOString(),
+        });
+    }
+    /**
+     * 将执行记录写入 SQLite。
+     * 使用 INSERT OR REPLACE 以支持状态更新（running → completed）。
+     */
+    writeExecution(record) {
+        try {
+            this.storage.writePatternExecution(record);
+        }
+        catch (err) {
+            logger.warn(`[Forge:追踪器] 写入执行记录失败：${err}`);
+        }
+    }
+    /**
+     * 查询指定 Pattern 的最近执行记录（供 PatternEvolver 使用）。
+     */
+    queryExecutions(patternId, limit = 50) {
+        try {
+            return this.storage.queryPatternExecutions(patternId, limit);
+        }
+        catch (err) {
+            logger.warn(`[Forge:追踪器] 查询执行记录失败：${err}`);
+            return [];
+        }
+    }
+    /** 更新用户满意度（+1 正向 / -1 负向 / 0 中性） */
+    updateSatisfaction(executionId, satisfaction) {
+        try {
+            this.storage.updatePatternSatisfaction(executionId, satisfaction);
+        }
+        catch (err) {
+            logger.warn(`[Forge:追踪器] 更新满意度失败：${err}`);
+        }
+    }
+}
+//# sourceMappingURL=execution-tracker.js.map

package/dist/pattern-engine/execution-tracker.js.map

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

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

@@ -0,0 +1,52 @@
+import { PatternLoader } from './pattern-loader.js';
+import { ExecutionTracer } from './execution-tracker.js';
+import type { ClaudeAPI } from '../utils/claude-api.js';
+import type { SQLiteStorage } from '../storage/sqlite.js';
+import type { Pattern, RouteResult, PatternContext, ExecutionPlan } from './types.js';
+import type { Convention } from '../convention/types.js';
+import type { ForgeEvent } from '../types/index.js';
+/**
+ * PatternEngine 门面类：统一入口，供 daemon handler 调用。
+ *
+ * Phase 1 提供：Pattern 加载与路由。
+ * Phase 2 扩展：PatternExecutor、ExecutionTracer。
+ * Phase 3 将在此扩展：PatternEvolver。
+ */
+export declare class PatternEngine {
+    private loader;
+    private router;
+    private executor;
+    private tracer;
+    private patterns;
+    constructor(api: ClaudeAPI, storage: SQLiteStorage);
+    /** 初始化：加载所有 Pattern 文件 */
+    initialize(): void;
+    /** 重新加载 Pattern 文件（热更新） */
+    reload(): void;
+    /** 路由用户输入到合适的 Pattern */
+    route(userInput: string, complexity?: 'simple' | 'moderate' | 'complex'): Promise<RouteResult>;
+    /**
+     * 路由并启动执行计划。
+     * 若命中 Pattern，创建 ExecutionPlan 并返回 PatternContext（含渲染后的 prompt）。
+     * 未命中返回 null，调用方继续走原有 Skill 编排路径。
+     */
+    routeAndStart(userInput: string, sessionId: string, projectPath: string, complexity?: 'simple' | 'moderate' | 'complex'): Promise<PatternContext | null>;
+    /** 从当前活跃计划生成 additionalContext 字符串（供 UserPromptHandler 注入） */
+    buildAdditionalContext(patternCtx: PatternContext, patternId: string, convention?: Convention | null): string | null;
+    /**
+     * 处理 PostToolUse 事件：检测 completion_signal → 推进状态机 → 记录轨迹。
+     * 返回下一阶段 ID（null 表示未推进或 Pattern 已完成）。
+     */
+    onPostToolUse(event: ForgeEvent): Promise<string | null>;
+    /** 获取当前活跃计划（供外部判断是否有活跃 Pattern） */
+    getActivePlan(projectPath: string): ExecutionPlan | null;
+    /** 返回所有已加载的 Pattern（只读） */
+    listPatterns(): readonly Pattern[];
+    /** 按 ID 查找 Pattern */
+    getPattern(id: string): Pattern | null;
+    /** 获取 PatternLoader（供 PatternEvolver 调用 savePattern） */
+    getLoader(): PatternLoader;
+    /** 获取 ExecutionTracer（供外部更新满意度） */
+    getTracer(): ExecutionTracer;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pattern-engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAiB;gBAErB,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa;IAOlD,0BAA0B;IAC1B,UAAU,IAAI,IAAI;IAMlB,2BAA2B;IAC3B,MAAM,IAAI,IAAI;IAMd,yBAAyB;IACnB,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAC7C,OAAO,CAAC,WAAW,CAAC;IAIvB;;;;OAIG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAC7C,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAejC,8DAA8D;IAC9D,sBAAsB,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI;IAMpH;;;OAGG;IACG,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiB9D,mCAAmC;IACnC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIxD,2BAA2B;IAC3B,YAAY,IAAI,SAAS,OAAO,EAAE;IAIlC,sBAAsB;IACtB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAItC,wDAAwD;IACxD,SAAS,IAAI,aAAa;IAI1B,mCAAmC;IACnC,SAAS,IAAI,eAAe;CAG7B"}

package/dist/pattern-engine/index.js

@@ -0,0 +1,104 @@
+import { PatternLoader } from './pattern-loader.js';
+import { PatternRouter } from './pattern-router.js';
+import { PatternExecutor } from './pattern-executor.js';
+import { ExecutionTracer } from './execution-tracker.js';
+import { logger } from '../utils/logger.js';
+/**
+ * PatternEngine 门面类：统一入口，供 daemon handler 调用。
+ *
+ * Phase 1 提供：Pattern 加载与路由。
+ * Phase 2 扩展：PatternExecutor、ExecutionTracer。
+ * Phase 3 将在此扩展：PatternEvolver。
+ */
+export class PatternEngine {
+    loader;
+    router;
+    executor;
+    tracer;
+    patterns = [];
+    constructor(api, storage) {
+        this.loader = new PatternLoader();
+        this.router = new PatternRouter(api);
+        this.executor = new PatternExecutor();
+        this.tracer = new ExecutionTracer(storage, this.executor);
+    }
+    /** 初始化：加载所有 Pattern 文件 */
+    initialize() {
+        this.patterns = this.loader.loadAll();
+        this.router.setPatterns(this.patterns);
+        logger.info(`[Pattern引擎] 已初始化，共 ${this.patterns.length} 个 Pattern`);
+    }
+    /** 重新加载 Pattern 文件（热更新） */
+    reload() {
+        this.patterns = this.loader.loadAll();
+        this.router.setPatterns(this.patterns);
+        logger.info(`[Pattern引擎] 已重新加载，共 ${this.patterns.length} 个 Pattern`);
+    }
+    /** 路由用户输入到合适的 Pattern */
+    async route(userInput, complexity) {
+        return this.router.route(userInput, complexity);
+    }
+    /**
+     * 路由并启动执行计划。
+     * 若命中 Pattern，创建 ExecutionPlan 并返回 PatternContext（含渲染后的 prompt）。
+     * 未命中返回 null，调用方继续走原有 Skill 编排路径。
+     */
+    async routeAndStart(userInput, sessionId, projectPath, complexity) {
+        const result = await this.route(userInput, complexity);
+        if (!result.pattern)
+            return null;
+        const pattern = result.pattern;
+        const plan = this.executor.startPlan(pattern, sessionId, projectPath);
+        // 记录第一个阶段的开始时间
+        if (plan.currentPhaseId) {
+            this.tracer.recordPhaseStart(plan.id, plan.currentPhaseId, pattern.id, sessionId, projectPath);
+        }
+        return this.executor.execute(pattern, plan, userInput);
+    }
+    /** 从当前活跃计划生成 additionalContext 字符串（供 UserPromptHandler 注入） */
+    buildAdditionalContext(patternCtx, patternId, convention) {
+        const pattern = this.patterns.find((p) => p.id === patternId) ?? null;
+        if (!pattern)
+            return null;
+        return this.executor.buildAdditionalContext(patternCtx, pattern, convention);
+    }
+    /**
+     * 处理 PostToolUse 事件：检测 completion_signal → 推进状态机 → 记录轨迹。
+     * 返回下一阶段 ID（null 表示未推进或 Pattern 已完成）。
+     */
+    async onPostToolUse(event) {
+        const plan = this.executor.getActivePlan(event.project_path);
+        if (!plan)
+            return null;
+        const pattern = this.patterns.find((p) => p.id === plan.patternId) ?? null;
+        if (!pattern)
+            return null;
+        const nextPhaseId = await this.tracer.onPostToolUse(event, pattern);
+        // 若推进到下一阶段，记录其开始时间
+        if (nextPhaseId) {
+            this.tracer.recordPhaseStart(plan.id, nextPhaseId, pattern.id, plan.sessionId, event.project_path);
+        }
+        return nextPhaseId;
+    }
+    /** 获取当前活跃计划（供外部判断是否有活跃 Pattern） */
+    getActivePlan(projectPath) {
+        return this.executor.getActivePlan(projectPath);
+    }
+    /** 返回所有已加载的 Pattern（只读） */
+    listPatterns() {
+        return this.patterns;
+    }
+    /** 按 ID 查找 Pattern */
+    getPattern(id) {
+        return this.patterns.find((p) => p.id === id) ?? null;
+    }
+    /** 获取 PatternLoader（供 PatternEvolver 调用 savePattern） */
+    getLoader() {
+        return this.loader;
+    }
+    /** 获取 ExecutionTracer（供外部更新满意度） */
+    getTracer() {
+        return this.tracer;
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,39 @@
+import type { ClaudeAPI } from '../utils/claude-api.js';
+import type { SQLiteStorage } from '../storage/sqlite.js';
+import type { Pattern } from './types.js';
+import type { Convention } from '../convention/types.js';
+interface EvolveResult {
+    patternId: string;
+    previousVersion: string;
+    newVersion: string;
+    changes: string[];
+}
+/**
+ * PatternEvolver：从执行历史学习，用 AI 优化 Pattern YAML。
+ * 触发条件：定时（evolve_interval_days）或阈值（evolve_min_executions）。
+ */
+export declare class PatternEvolver {
+    private api;
+    private storage;
+    private loader;
+    private defaultMinExecutions;
+    constructor(api: ClaudeAPI, storage: SQLiteStorage, defaultMinExecutions?: number);
+    /**
+     * 对所有 Pattern 执行自进化。
+     * 返回每个实际被优化的 Pattern 的进化报告。
+     * convention 参数可选，传入时约束所有 Pattern 的进化不得违反其 must 级规则。
+     */
+    evolve(minExecutions?: number, convention?: Convention | null): Promise<EvolveResult[]>;
+    /**
+     * 对单个 Pattern 执行自进化。
+     * 执行次数不足时跳过，返回 null。
+     * convention 参数可选，传入时 AI 优化不得违反其 must 级质量标准。
+     */
+    evolvePattern(pattern: Pattern, minExecutions?: number, convention?: Convention | null): Promise<EvolveResult | null>;
+    private computeMetrics;
+    private optimizeWithAI;
+    private bumpVersion;
+    private writeBack;
+}
+export {};
+//# sourceMappingURL=pattern-evolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-evolver.d.ts","sourceRoot":"","sources":["../../src/pattern-engine/pattern-evolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAWzD,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,oBAAoB,SAAK;IAO7E;;;;OAIG;IACG,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiB7F;;;;OAIG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,SAAK,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAqCvH,OAAO,CAAC,cAAc;YAuBR,cAAc;IAkE5B,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,SAAS;CAmBlB"}

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

@@ -0,0 +1,170 @@
+import fs from 'fs';
+import yaml from 'js-yaml';
+import { logger } from '../utils/logger.js';
+import { PatternLoader } from './pattern-loader.js';
+/**
+ * PatternEvolver：从执行历史学习，用 AI 优化 Pattern YAML。
+ * 触发条件：定时（evolve_interval_days）或阈值（evolve_min_executions）。
+ */
+export class PatternEvolver {
+    api;
+    storage;
+    loader;
+    defaultMinExecutions;
+    constructor(api, storage, defaultMinExecutions = 20) {
+        this.api = api;
+        this.storage = storage;
+        this.loader = new PatternLoader();
+        this.defaultMinExecutions = defaultMinExecutions;
+    }
+    /**
+     * 对所有 Pattern 执行自进化。
+     * 返回每个实际被优化的 Pattern 的进化报告。
+     * convention 参数可选，传入时约束所有 Pattern 的进化不得违反其 must 级规则。
+     */
+    async evolve(minExecutions, convention) {
+        const threshold = minExecutions ?? this.defaultMinExecutions;
+        const patterns = this.loader.loadAll();
+        const results = [];
+        for (const pattern of patterns) {
+            try {
+                const result = await this.evolvePattern(pattern, threshold, convention);
+                if (result)
+                    results.push(result);
+            }
+            catch (err) {
+                logger.warn(`[Pattern进化器] ${pattern.id} 进化失败：${err}`);
+            }
+        }
+        return results;
+    }
+    /**
+     * 对单个 Pattern 执行自进化。
+     * 执行次数不足时跳过，返回 null。
+     * convention 参数可选，传入时 AI 优化不得违反其 must 级质量标准。
+     */
+    async evolvePattern(pattern, minExecutions = 20, convention) {
+        const executions = this.storage.queryPatternExecutions(pattern.id, 50);
+        if (executions.length < minExecutions) {
+            logger.info(`[Pattern进化器] ${pattern.id} 执行次数不足（${executions.length}/${minExecutions}），跳过`);
+            return null;
+        }
+        const metrics = this.computeMetrics(executions);
+        const problemPhases = metrics.filter((m) => m.completed / m.total < 0.6 || m.avgSatisfaction < 0);
+        if (problemPhases.length === 0) {
+            logger.info(`[Pattern进化器] ${pattern.id} 各阶段健康，无需优化`);
+            return null;
+        }
+        logger.info(`[Pattern进化器] ${pattern.id} 发现 ${problemPhases.length} 个问题阶段，启动 AI 优化`);
+        const optimized = await this.optimizeWithAI(pattern, metrics, problemPhases, convention);
+        if (!optimized)
+            return null;
+        const previousVersion = pattern.version;
+        const newVersion = this.bumpVersion(pattern.version);
+        optimized.version = newVersion;
+        this.writeBack(pattern, optimized);
+        const changes = problemPhases.map((m) => `阶段 ${m.phaseId} 完成率 ${((m.completed / m.total) * 100).toFixed(0)}% → 已优化`);
+        logger.info(`[Pattern进化器] ${pattern.id} 进化完成 v${previousVersion} → v${newVersion}`);
+        return { patternId: pattern.id, previousVersion, newVersion, changes };
+    }
+    // ── 私有方法 ──────────────────────────────────────────────────────────────
+    computeMetrics(executions) {
+        const byPhase = new Map();
+        for (const e of executions) {
+            const list = byPhase.get(e.phase_id) ?? [];
+            list.push(e);
+            byPhase.set(e.phase_id, list);
+        }
+        const metrics = [];
+        for (const [phaseId, records] of byPhase) {
+            const completed = records.filter((r) => r.status === 'completed').length;
+            const failed = records.filter((r) => r.status === 'failed').length;
+            const durations = records.filter((r) => r.duration_ms != null).map((r) => r.duration_ms);
+            const avgDurationMs = durations.length > 0 ? durations.reduce((a, b) => a + b, 0) / durations.length : 0;
+            const satisfactions = records.filter((r) => r.user_satisfaction != null).map((r) => r.user_satisfaction);
+            const avgSatisfaction = satisfactions.length > 0 ? satisfactions.reduce((a, b) => a + b, 0) / satisfactions.length : 0;
+            metrics.push({ phaseId, total: records.length, completed, failed, avgDurationMs, avgSatisfaction });
+        }
+        return metrics;
+    }
+    async optimizeWithAI(pattern, allMetrics, problemPhases, convention) {
+        const metricsText = allMetrics.map((m) => `  ${m.phaseId}: 完成率=${((m.completed / m.total) * 100).toFixed(0)}% 失败=${m.failed} ` +
+            `平均耗时=${(m.avgDurationMs / 1000).toFixed(1)}s 满意度=${m.avgSatisfaction.toFixed(2)}`).join('\n');
+        const problemText = problemPhases.map((m) => m.phaseId).join(', ');
+        const currentYaml = yaml.dump({
+            id: pattern.id,
+            name: pattern.name,
+            version: pattern.version,
+            description: pattern.description,
+            trigger: pattern.trigger,
+            phases: pattern.phases,
+            evolution: pattern.evolution,
+        });
+        const mustRules = convention?.quality_standards?.filter((s) => s.severity === 'must') ?? [];
+        const conventionSection = mustRules.length > 0
+            ? `\n## Convention 约束（${convention.name}，不得违反）\n` +
+                mustRules.map((r) => `- [${r.category}] ${r.rule}`).join('\n') + '\n'
+            : '';
+        const prompt = `你是一个 Pattern 进化专家。根据执行数据，优化以下工作流 Pattern 的问题阶段。
+
+## 执行指标
+${metricsText}
+
+## 问题阶段
+${problemText}
+
+## 当前 Pattern YAML
+\`\`\`yaml
+${currentYaml}
+\`\`\`
+${conventionSection}
+## 优化任务
+针对问题阶段（完成率<60% 或用户满意度<0），优化其 prompt_template 或 tools_allowed：
+- 让 prompt 更具体、可执行
+- 减少模糊指令
+- 确保 completion_signal 合理${mustRules.length > 0 ? '\n- 优化后的 prompt_template 必须符合上方 Convention 约束，不得与 must 级规则冲突' : ''}
+
+## 输出格式
+输出完整优化后的 YAML（与输入格式一致），无其他文字。`;
+        try {
+            const response = await this.api.complete(prompt, 'pattern-evolver', 0, 60_000);
+            const yamlMatch = response.match(/```yaml\n([\s\S]*?)```/) ?? response.match(/^([\s\S]+)$/);
+            if (!yamlMatch)
+                return null;
+            const parsed = yaml.load(yamlMatch[1]);
+            if (!parsed?.id || !parsed?.phases)
+                return null;
+            return parsed;
+        }
+        catch (err) {
+            logger.warn(`[Pattern进化器] AI 优化失败：${err}`);
+            return null;
+        }
+    }
+    bumpVersion(version) {
+        const parts = version.split('.');
+        if (parts.length >= 2) {
+            const minor = parseFloat(parts[1] ?? '0') + 1;
+            return `${parts[0]}.${minor}`;
+        }
+        return `${version}.1`;
+    }
+    writeBack(original, optimized) {
+        if (!original.filePath) {
+            logger.warn(`[Pattern进化器] ${original.id} 无文件路径，跳过写回`);
+            return;
+        }
+        const toWrite = yaml.dump({
+            id: optimized.id,
+            name: optimized.name,
+            version: optimized.version,
+            description: optimized.description,
+            source: original.source,
+            trigger: optimized.trigger,
+            phases: optimized.phases,
+            evolution: optimized.evolution,
+        }, { lineWidth: 120 });
+        fs.writeFileSync(original.filePath, toWrite, 'utf-8');
+    }
+}
+//# sourceMappingURL=pattern-evolver.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { Pattern, ExecutionPlan, PatternContext } from './types.js';
+import type { Convention } from '../convention/types.js';
+/**
+ * PatternExecutor：将匹配到的 Pattern 展开为 ExecutionPlan，
+ * 渲染当前阶段的 prompt_template，生成注入给 Claude 的 additionalContext。
+ *
+ * 职责边界：
+ * - 创建和管理内存中的 ExecutionPlan（持久化由 ExecutionTracer 负责）
+ * - 模板渲染
+ * - 生成 PatternContext 供 UserPromptHandler 注入
+ *
+ * 不负责：AI 调用、SQLite 写入、状态机推进
+ */
+export declare class PatternExecutor {
+    /** 按 projectPath 存储当前活跃的执行计划（每个项目同时只有一个） */
+    private activePlans;
+    /**
+     * 为指定项目启动一个新的执行计划。
+     * 若该项目已有活跃计划，先清除（不支持并发 Pattern 执行）。
+     */
+    startPlan(pattern: Pattern, sessionId: string, projectPath: string): ExecutionPlan;
+    /**
+     * 生成当前活跃阶段的 PatternContext（含渲染后的 prompt）。
+     * 返回 null 表示无活跃计划或当前阶段已执行完毕。
+     */
+    execute(pattern: Pattern, plan: ExecutionPlan, requirement: string): PatternContext | null;
+    /**
+     * 将指定阶段标记为已完成，并推进到下一个可执行阶段。
+     * 供 ExecutionTracer 在检测到 completion_signal 时调用。
+     *
+     * @returns 下一个阶段 ID，null 表示整个 Pattern 已执行完毕
+     */
+    advancePhase(projectPath: string, completedPhaseId: string, phaseOutput: string, pattern: Pattern): string | null;
+    /** 获取项目当前活跃计划（不存在则返回 null） */
+    getActivePlan(projectPath: string): ExecutionPlan | null;
+    /** 清除项目的活跃计划（Pattern 完成或被中断时调用） */
+    clearPlan(projectPath: string): void;
+    /** 构建注入给 Claude 的 additionalContext 字符串，可选传入 Convention 以注入角色约束 */
+    buildAdditionalContext(patternCtx: PatternContext, pattern: Pattern, convention?: Convention | null): string;
+    /** 检测 PostToolUse 事件是否触发了当前阶段的 completion_signal */
+    checkCompletionSignal(projectPath: string, toolName: string, toolInput: Record<string, unknown>, pattern: Pattern): boolean;
+}
+//# sourceMappingURL=pattern-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-executor.d.ts","sourceRoot":"","sources":["../../src/pattern-engine/pattern-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAgB,aAAa,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAC;AACzG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA4BzD;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,4CAA4C;IAC5C,OAAO,CAAC,WAAW,CAAoC;IAEvD;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa;IA4BlF;;;OAGG;IACH,OAAO,CACL,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,GAClB,cAAc,GAAG,IAAI;IAwBxB;;;;;OAKG;IACH,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,MAAM,GAAG,IAAI;IA2BhB,8BAA8B;IAC9B,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIxD,mCAAmC;IACnC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKpC,mEAAmE;IACnE,sBAAsB,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM;IAkC5G,oDAAoD;IACpD,qBAAqB,CACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE,OAAO,GACf,OAAO;CAqBX"}