autosnippet 3.3.5 → 3.3.7

package/dist/lib/service/evolution/ProposalExecutor.d.ts

@@ -17,6 +17,8 @@
  */
 import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
 import type { ProposalRepository, ProposalType } from '../../repository/evolution/ProposalRepository.js';
+import type { ContentPatcher } from './ContentPatcher.js';
+import type { RecipeLifecycleSupervisor } from './RecipeLifecycleSupervisor.js';
 interface DatabaseLike {
     prepare(sql: string): {
         all(...params: unknown[]): Record<string, unknown>[];
@@ -51,6 +53,8 @@ export declare class ProposalExecutor {
     #private;
     constructor(db: DatabaseLike, repo: ProposalRepository, options?: {
         signalBus?: SignalBus;
+        contentPatcher?: ContentPatcher;
+        supervisor?: RecipeLifecycleSupervisor;
     });
     /**
      * 定期调用（UiStartupTasks Stage 5）

package/dist/lib/service/evolution/ProposalExecutor.js

@@ -26,11 +26,15 @@ export class ProposalExecutor {
     #db;
     #repo;
     #signalBus;
+    #contentPatcher;
+    #supervisor;
     #logger = Logger.getInstance();
     constructor(db, repo, options = {}) {
         this.#db = db;
         this.#repo = repo;
         this.#signalBus = options.signalBus ?? null;
+        this.#contentPatcher = options.contentPatcher ?? null;
+        this.#supervisor = options.supervisor ?? null;
     }
     /**
      * 定期调用（UiStartupTasks Stage 5）
@@ -100,9 +104,22 @@ export class ProposalExecutor {
         const fpOk = metrics.ruleFalsePositiveRate < 0.4;
         const hasUsage = metrics.guardHits > 0 || metrics.searchHits > 0;
         if (fpOk && hasUsage) {
-            // 通过 → 将 Recipe 回到 staging（重新走 ConfidenceRouter）
-            this.#transitionRecipe(proposal.targetRecipeId, 'staging');
-            this.#repo.markExecuted(proposal.id, `观察期表现合格: FP=${(metrics.ruleFalsePositiveRate * 100).toFixed(0)}%, hits=${metrics.guardHits + metrics.searchHits}`);
+            // 通过 → evolving → ContentPatcher → staging（重走 Grace Period）
+            this.#transitionRecipe(proposal.targetRecipeId, 'evolving', 'proposal-attach', proposal.id);
+            const patchResult = this.#tryApplyPatch(proposal, 'agent-suggestion');
+            if (patchResult?.skipped || (!patchResult?.success && patchResult !== null)) {
+                // Patch 跳过或失败 → 回退到 active，避免无变更进入 staging 导致空进化循环
+                this.#transitionRecipe(proposal.targetRecipeId, 'active', 'content-patch-complete', proposal.id);
+                const skipInfo = patchResult?.skipReason ? `: ${patchResult.skipReason}` : '';
+                this.#repo.markExecuted(proposal.id, `观察期合格但 patch 未生效${skipInfo}, 回退 active`);
+            }
+            else {
+                this.#transitionRecipe(proposal.targetRecipeId, 'staging', 'content-patch-complete', proposal.id);
+                const patchInfo = patchResult?.success
+                    ? `, patched=[${patchResult.fieldsPatched.join(',')}]`
+                    : '';
+                this.#repo.markExecuted(proposal.id, `观察期表现合格: FP=${(metrics.ruleFalsePositiveRate * 100).toFixed(0)}%, hits=${metrics.guardHits + metrics.searchHits}${patchInfo}`);
+            }
             result.executed.push({
                 id: proposal.id,
                 type: proposal.type,
@@ -151,7 +168,7 @@ export class ProposalExecutor {
         const newUsage = newMetrics.guardHits + newMetrics.searchHits;
         if (newUsage >= oldUsage * 0.5 || oldUsage === 0) {
             // 新 Recipe 表现足够 → 旧 Recipe → decaying，建立 deprecated_by
-            this.#transitionRecipe(proposal.targetRecipeId, 'decaying');
+            this.#transitionRecipe(proposal.targetRecipeId, 'decaying', 'proposal-execution', proposal.id);
             this.#createDeprecatedByEdge(newRecipeId, proposal.targetRecipeId);
             this.#repo.markExecuted(proposal.id, `supersede executed: new usage=${newUsage}, old usage=${oldUsage}`);
             result.executed.push({
@@ -192,12 +209,12 @@ export class ProposalExecutor {
         // 无回升 → 根据 decayScore 决定操作
         if (currentDecay <= 19) {
             // 死亡 → 直接 deprecated
-            this.#transitionRecipe(proposal.targetRecipeId, 'deprecated');
+            this.#transitionRecipe(proposal.targetRecipeId, 'deprecated', 'proposal-execution', proposal.id);
             this.#repo.markExecuted(proposal.id, `deprecated (dead): decayScore=${currentDecay}`);
         }
         else if (currentDecay <= 40) {
             // 严重 → decaying
-            this.#transitionRecipe(proposal.targetRecipeId, 'decaying');
+            this.#transitionRecipe(proposal.targetRecipeId, 'decaying', 'proposal-execution', proposal.id);
             this.#repo.markExecuted(proposal.id, `decaying (severe): decayScore=${currentDecay}`);
         }
         else {
@@ -221,11 +238,24 @@ export class ProposalExecutor {
     }
     /* ── correction ── */
     #executeCorrection(proposal, metrics, result) {
-        // correction 低风险，到期直接执行（Recipe → staging 重新审核）
+        // correction 低风险，到期直接执行（Recipe → evolving → patch → staging 重新审核）
         const hasUsage = metrics.guardHits > 0 || metrics.searchHits > 0;
         if (hasUsage) {
-            this.#transitionRecipe(proposal.targetRecipeId, 'staging');
-            this.#repo.markExecuted(proposal.id, 'correction applied, recipe → staging for re-review');
+            this.#transitionRecipe(proposal.targetRecipeId, 'evolving', 'proposal-attach', proposal.id);
+            const patchResult = this.#tryApplyPatch(proposal, 'correction');
+            if (patchResult?.skipped || (!patchResult?.success && patchResult !== null)) {
+                // Patch 跳过或失败 → 回退到 active
+                this.#transitionRecipe(proposal.targetRecipeId, 'active', 'content-patch-complete', proposal.id);
+                const skipInfo = patchResult?.skipReason ? `: ${patchResult.skipReason}` : '';
+                this.#repo.markExecuted(proposal.id, `correction patch 未生效${skipInfo}, 回退 active`);
+            }
+            else {
+                this.#transitionRecipe(proposal.targetRecipeId, 'staging', 'content-patch-complete', proposal.id);
+                const patchInfo = patchResult?.success
+                    ? `, patched=[${patchResult.fieldsPatched.join(',')}]`
+                    : '';
+                this.#repo.markExecuted(proposal.id, `correction applied, recipe → evolving → staging for re-review${patchInfo}`);
+            }
             result.executed.push({
                 id: proposal.id,
                 type: proposal.type,
@@ -306,10 +336,28 @@ export class ProposalExecutor {
             .get(recipeId);
         return row ?? null;
     }
-    #transitionRecipe(recipeId, newLifecycle) {
-        this.#db
-            .prepare(`UPDATE knowledge_entries SET lifecycle = ?, updatedAt = ? WHERE id = ?`)
-            .run(newLifecycle, Date.now(), recipeId);
+    #transitionRecipe(recipeId, newLifecycle, trigger = 'proposal-execution', proposalId) {
+        if (this.#supervisor) {
+            const result = this.#supervisor.transition({
+                recipeId,
+                targetState: newLifecycle,
+                trigger,
+                proposalId,
+                operatorId: 'system',
+            });
+            if (!result.success) {
+                this.#logger.warn(`[ProposalExecutor] Supervisor rejected transition ${recipeId} → ${newLifecycle}: ${result.error}`);
+                // Fallback to raw DB update for backward compatibility
+                this.#db
+                    .prepare(`UPDATE knowledge_entries SET lifecycle = ?, updatedAt = ? WHERE id = ?`)
+                    .run(newLifecycle, Date.now(), recipeId);
+            }
+        }
+        else {
+            this.#db
+                .prepare(`UPDATE knowledge_entries SET lifecycle = ?, updatedAt = ? WHERE id = ?`)
+                .run(newLifecycle, Date.now(), recipeId);
+        }
     }
     #restoreRecipe(recipeId) {
         // 恢复到 active（evolving/decaying → active）
@@ -318,6 +366,22 @@ export class ProposalExecutor {
             this.#transitionRecipe(recipeId, 'active');
         }
     }
+    /**
+     * 尝试通过 ContentPatcher 应用 Proposal 中的 suggestedChanges
+     * 降级容忍：无 ContentPatcher 或 patch 失败时返回 null/skipped，不阻塞状态转移
+     */
+    #tryApplyPatch(proposal, patchSource) {
+        if (!this.#contentPatcher) {
+            return null;
+        }
+        try {
+            return this.#contentPatcher.applyProposal(proposal, patchSource);
+        }
+        catch (err) {
+            this.#logger.warn(`[ProposalExecutor] ContentPatcher failed for proposal ${proposal.id}: ${err instanceof Error ? err.message : String(err)}`);
+            return null;
+        }
+    }
     #createDeprecatedByEdge(newRecipeId, oldRecipeId) {
         const now = Date.now();
         try {

package/dist/lib/service/evolution/RecipeLifecycleSupervisor.d.ts

@@ -0,0 +1,64 @@
+/**
+ * RecipeLifecycleSupervisor — 统一状态转移管理层
+ *
+ * 核心职责：
+ *   1. Guard 前置检查 — 验证转移是否合法（VALID_TRANSITIONS + 扩展条件）
+ *   2. Entry/Exit Actions — 进入/离开状态的固定副作用
+ *   3. Event 记录 — 每次转移记录为不可变 TransitionEvent
+ *   4. 超时监控 — 中间态超时自动处理
+ *   5. 健康摘要 — 全局状态分布与卡死检测
+ *
+ * 所有状态变更建议通过 Supervisor，目前作为可选增强层存在。
+ * 不改变现有 ProposalExecutor/StagingManager 的内部逻辑，
+ * 而是在它们之上提供审计、超时检查和健康监控。
+ *
+ * 触发时机：UiStartupTasks Stage 6（新增）
+ *
+ * @module service/evolution/RecipeLifecycleSupervisor
+ */
+import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
+import type { LifecycleHealthSummary, TimeoutCheckResult, TransitionEvent, TransitionRequest, TransitionResult } from '../../types/evolution.js';
+interface DatabaseLike {
+    prepare(sql: string): {
+        all(...params: unknown[]): Record<string, unknown>[];
+        get(...params: unknown[]): Record<string, unknown> | undefined;
+        run(...params: unknown[]): {
+            changes: number;
+        };
+    };
+}
+export declare class RecipeLifecycleSupervisor {
+    #private;
+    constructor(db: DatabaseLike, options?: {
+        signalBus?: SignalBus;
+    });
+    /**
+     * 执行状态转移 — 统一入口
+     *
+     * 1. 获取当前状态
+     * 2. Guard 检查（合法转移 + 扩展条件）
+     * 3. Exit Action（离开旧状态）
+     * 4. 更新 lifecycle
+     * 5. Entry Action（进入新状态）
+     * 6. 记录 TransitionEvent
+     * 7. 发射信号
+     */
+    transition(request: TransitionRequest): TransitionResult;
+    /**
+     * 检查中间态超时 + 自动处理
+     *
+     * 处理范围:
+     *   - evolving > 7d → active（回退）
+     *   - decaying > 30d → deprecated
+     */
+    checkTimeouts(): TimeoutCheckResult;
+    /**
+     * 查询 Recipe 的转移历史
+     */
+    getTransitionHistory(recipeId: string, limit?: number): TransitionEvent[];
+    /**
+     * 获取全局状态健康摘要
+     */
+    getHealthSummary(): LifecycleHealthSummary;
+}
+export {};

package/dist/lib/service/evolution/RecipeLifecycleSupervisor.js

@@ -0,0 +1,458 @@
+/**
+ * RecipeLifecycleSupervisor — 统一状态转移管理层
+ *
+ * 核心职责：
+ *   1. Guard 前置检查 — 验证转移是否合法（VALID_TRANSITIONS + 扩展条件）
+ *   2. Entry/Exit Actions — 进入/离开状态的固定副作用
+ *   3. Event 记录 — 每次转移记录为不可变 TransitionEvent
+ *   4. 超时监控 — 中间态超时自动处理
+ *   5. 健康摘要 — 全局状态分布与卡死检测
+ *
+ * 所有状态变更建议通过 Supervisor，目前作为可选增强层存在。
+ * 不改变现有 ProposalExecutor/StagingManager 的内部逻辑，
+ * 而是在它们之上提供审计、超时检查和健康监控。
+ *
+ * 触发时机：UiStartupTasks Stage 6（新增）
+ *
+ * @module service/evolution/RecipeLifecycleSupervisor
+ */
+import { randomUUID } from 'node:crypto';
+import { isValidTransition } from '../../domain/knowledge/Lifecycle.js';
+import Logger from '../../infrastructure/logging/Logger.js';
+/* ────────────────────── Constants ────────────────────── */
+/** 中间态超时配置（毫秒） */
+const TIMEOUT_MS = {
+    evolving: 7 * 24 * 60 * 60 * 1000, // 7 天
+    decaying: 30 * 24 * 60 * 60 * 1000, // 30 天
+    staging: 7 * 24 * 60 * 60 * 1000, // 7 天（安全兜底，正常由 StagingManager 处理）
+    pending: 30 * 24 * 60 * 60 * 1000, // 30 天
+};
+/** 超时后的目标状态 */
+const TIMEOUT_TARGET = {
+    evolving: 'active', // 回退到 active（内容不变）
+    decaying: 'deprecated', // 长期衰退 → 废弃
+    pending: 'deprecated', // 30 天未审核 → 废弃
+};
+/** 卡死告警阈值（毫秒） */
+const STUCK_THRESHOLD_MS = {
+    evolving: 3 * 24 * 60 * 60 * 1000, // > 3天
+    decaying: 15 * 24 * 60 * 60 * 1000, // > 15天
+    staging: 3 * 24 * 60 * 60 * 1000, // > 3天
+    pending: 7 * 24 * 60 * 60 * 1000, // > 7天
+};
+/* ────────────────────── Entry/Exit Action Types ────────────────────── */
+/** 进入状态时写入 stats 的元数据键 */
+const ENTRY_META_KEYS = {
+    staging: 'stagingEnteredAt',
+    evolving: 'evolvingStartedAt',
+    decaying: 'decayStartedAt',
+    active: 'activeSince',
+};
+/* ────────────────────── Class ────────────────────── */
+export class RecipeLifecycleSupervisor {
+    #db;
+    #signalBus;
+    #logger = Logger.getInstance();
+    constructor(db, options = {}) {
+        this.#db = db;
+        this.#signalBus = options.signalBus ?? null;
+    }
+    /* ═══════════════════ Core Transition ═══════════════════ */
+    /**
+     * 执行状态转移 — 统一入口
+     *
+     * 1. 获取当前状态
+     * 2. Guard 检查（合法转移 + 扩展条件）
+     * 3. Exit Action（离开旧状态）
+     * 4. 更新 lifecycle
+     * 5. Entry Action（进入新状态）
+     * 6. 记录 TransitionEvent
+     * 7. 发射信号
+     */
+    transition(request) {
+        const { recipeId, targetState, trigger, evidence, proposalId, operatorId } = request;
+        const opId = operatorId ?? 'system';
+        // 1. 获取当前状态
+        const current = this.#getRecipeState(recipeId);
+        if (!current) {
+            return {
+                success: false,
+                fromState: 'unknown',
+                toState: targetState,
+                error: 'Recipe not found',
+            };
+        }
+        const fromState = current.lifecycle;
+        // 2. Guard 检查
+        if (!isValidTransition(fromState, targetState)) {
+            this.#logger.warn(`[Supervisor] Invalid transition: ${recipeId} ${fromState} → ${targetState} (trigger: ${trigger})`);
+            return {
+                success: false,
+                fromState,
+                toState: targetState,
+                error: `Invalid transition: ${fromState} → ${targetState}`,
+            };
+        }
+        // 3. Exit Action
+        this.#executeExitAction(recipeId, fromState);
+        // 4. 更新 lifecycle
+        const now = Date.now();
+        this.#db
+            .prepare(`UPDATE knowledge_entries SET lifecycle = ?, updatedAt = ? WHERE id = ?`)
+            .run(targetState, now, recipeId);
+        // 5. Entry Action
+        this.#executeEntryAction(recipeId, targetState, now, proposalId);
+        // 6. 记录 TransitionEvent
+        const event = this.#recordEvent({
+            recipeId,
+            fromState,
+            toState: targetState,
+            trigger,
+            evidence: evidence ?? null,
+            proposalId: proposalId ?? null,
+            operatorId: opId,
+            createdAt: now,
+        });
+        // 7. 发射信号
+        this.#emitSignal(recipeId, fromState, targetState, trigger);
+        this.#logger.info(`[Supervisor] ${recipeId}: ${fromState} → ${targetState} (trigger: ${trigger})`);
+        return { success: true, fromState, toState: targetState, event };
+    }
+    /* ═══════════════════ Timeout Check ═══════════════════ */
+    /**
+     * 检查中间态超时 + 自动处理
+     *
+     * 处理范围:
+     *   - evolving > 7d → active（回退）
+     *   - decaying > 30d → deprecated
+     */
+    checkTimeouts() {
+        const result = { timedOut: [], checked: 0 };
+        const now = Date.now();
+        for (const [state, timeoutMs] of Object.entries(TIMEOUT_MS)) {
+            if (!(state in TIMEOUT_TARGET)) {
+                continue;
+            }
+            const targetState = TIMEOUT_TARGET[state];
+            const rows = this.#db
+                .prepare(`SELECT id, stats FROM knowledge_entries WHERE lifecycle = ?`)
+                .all(state);
+            result.checked += rows.length;
+            for (const row of rows) {
+                const stats = safeJsonParse(row.stats, {});
+                const entryKey = ENTRY_META_KEYS[state];
+                const enteredAt = (entryKey ? stats[entryKey] : null);
+                // 用 updatedAt 作为 fallback
+                const stateAge = enteredAt ? now - enteredAt : this.#getRecipeAge(row.id, now);
+                if (stateAge > timeoutMs) {
+                    const transitionResult = this.transition({
+                        recipeId: row.id,
+                        targetState,
+                        trigger: 'timeout-recovery',
+                        evidence: {
+                            reason: `${state} timeout after ${Math.round(stateAge / (24 * 60 * 60 * 1000))}d`,
+                        },
+                    });
+                    if (transitionResult.success) {
+                        result.timedOut.push({
+                            recipeId: row.id,
+                            fromState: state,
+                            toState: targetState,
+                            age: stateAge,
+                        });
+                    }
+                }
+            }
+        }
+        if (result.timedOut.length > 0) {
+            this.#logger.info(`[Supervisor] Timeout check: ${result.timedOut.length} recipes timed out (checked: ${result.checked})`);
+        }
+        return result;
+    }
+    /* ═══════════════════ Query ═══════════════════ */
+    /**
+     * 查询 Recipe 的转移历史
+     */
+    getTransitionHistory(recipeId, limit = 50) {
+        try {
+            const rows = this.#db
+                .prepare(`SELECT id, recipe_id, from_state, to_state, trigger, operator_id,
+                  evidence_json, proposal_id, created_at
+           FROM lifecycle_transition_events
+           WHERE recipe_id = ?
+           ORDER BY created_at DESC
+           LIMIT ?`)
+                .all(recipeId, limit);
+            return rows.map((row) => this.#rowToEvent(row));
+        }
+        catch {
+            // 表可能不存在（migration 未运行）
+            return [];
+        }
+    }
+    /**
+     * 获取全局状态健康摘要
+     */
+    getHealthSummary() {
+        const now = Date.now();
+        // 状态分布
+        const stateDistribution = this.#getStateDistribution();
+        // 中间态卡死检测
+        const intermediateStates = {
+            stuckEvolving: this.#getStuckInfo('evolving', STUCK_THRESHOLD_MS.evolving, now),
+            stuckDecaying: this.#getStuckInfo('decaying', STUCK_THRESHOLD_MS.decaying, now),
+            stuckStaging: this.#getStuckInfo('staging', STUCK_THRESHOLD_MS.staging, now),
+            stuckPending: this.#getStuckInfo('pending', STUCK_THRESHOLD_MS.pending, now),
+        };
+        // 最近转移统计
+        const recentTransitions = this.#getRecentTransitionStats(now);
+        // Proposal 指标
+        const proposalMetrics = this.#getProposalMetrics();
+        return { stateDistribution, intermediateStates, recentTransitions, proposalMetrics };
+    }
+    /* ═══════════════════ Entry/Exit Actions ═══════════════════ */
+    #executeEntryAction(recipeId, state, now, proposalId) {
+        const metaKey = ENTRY_META_KEYS[state];
+        if (!metaKey) {
+            return;
+        }
+        const statsRow = this.#db
+            .prepare(`SELECT stats FROM knowledge_entries WHERE id = ?`)
+            .get(recipeId);
+        const stats = safeJsonParse(statsRow?.stats, {});
+        stats[metaKey] = now;
+        if (state === 'evolving' && proposalId) {
+            stats.evolvingProposalId = proposalId;
+        }
+        if (state === 'active') {
+            // 清除中间态元数据
+            delete stats.evolvingStartedAt;
+            delete stats.evolvingProposalId;
+            delete stats.decayStartedAt;
+        }
+        if (state === 'deprecated') {
+            stats.deprecatedAt = now;
+        }
+        this.#db
+            .prepare(`UPDATE knowledge_entries SET stats = ? WHERE id = ?`)
+            .run(JSON.stringify(stats), recipeId);
+    }
+    #executeExitAction(recipeId, state) {
+        if (state === 'active') {
+            // 记录 lastActiveAt
+            const statsRow = this.#db
+                .prepare(`SELECT stats FROM knowledge_entries WHERE id = ?`)
+                .get(recipeId);
+            const stats = safeJsonParse(statsRow?.stats, {});
+            stats.lastActiveAt = Date.now();
+            this.#db
+                .prepare(`UPDATE knowledge_entries SET stats = ? WHERE id = ?`)
+                .run(JSON.stringify(stats), recipeId);
+        }
+        // staging exit: 清除 staging 元数据（由 StagingManager 自行处理）
+    }
+    /* ═══════════════════ Event Recording ═══════════════════ */
+    #recordEvent(params) {
+        const id = randomUUID();
+        const event = {
+            id,
+            recipeId: params.recipeId,
+            fromState: params.fromState,
+            toState: params.toState,
+            trigger: params.trigger,
+            evidence: params.evidence,
+            proposalId: params.proposalId,
+            operatorId: params.operatorId,
+            createdAt: params.createdAt,
+        };
+        try {
+            this.#db
+                .prepare(`INSERT INTO lifecycle_transition_events
+           (id, recipe_id, from_state, to_state, trigger, operator_id, evidence_json, proposal_id, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(id, params.recipeId, params.fromState, params.toState, params.trigger, params.operatorId, params.evidence ? JSON.stringify(params.evidence) : null, params.proposalId, params.createdAt);
+        }
+        catch {
+            // lifecycle_transition_events 表可能不存在（降级容忍）
+            this.#logger.warn(`[Supervisor] Failed to record transition event (table may not exist)`);
+        }
+        return event;
+    }
+    /* ═══════════════════ Health Queries ═══════════════════ */
+    #getStateDistribution() {
+        const dist = {
+            pending: 0,
+            staging: 0,
+            active: 0,
+            evolving: 0,
+            decaying: 0,
+            deprecated: 0,
+        };
+        try {
+            const rows = this.#db
+                .prepare(`SELECT lifecycle, COUNT(*) as cnt FROM knowledge_entries GROUP BY lifecycle`)
+                .all();
+            for (const row of rows) {
+                dist[row.lifecycle] = row.cnt;
+            }
+        }
+        catch {
+            // fallback
+        }
+        return dist;
+    }
+    #getStuckInfo(state, thresholdMs, now) {
+        try {
+            const rows = this.#db
+                .prepare(`SELECT id, stats, updatedAt FROM knowledge_entries WHERE lifecycle = ?`)
+                .all(state);
+            let count = 0;
+            let oldestAge = 0;
+            for (const row of rows) {
+                const stats = safeJsonParse(row.stats, {});
+                const metaKey = ENTRY_META_KEYS[state];
+                const enteredAt = (metaKey ? stats[metaKey] : null);
+                const age = enteredAt ? now - enteredAt : now - (row.updatedAt || now);
+                if (age > thresholdMs) {
+                    count++;
+                    if (age > oldestAge) {
+                        oldestAge = age;
+                    }
+                }
+            }
+            return { count, oldestAge };
+        }
+        catch {
+            return { count: 0, oldestAge: 0 };
+        }
+    }
+    #getRecentTransitionStats(now) {
+        try {
+            const last24hCount = this.#db
+                .prepare(`SELECT COUNT(*) as cnt FROM lifecycle_transition_events WHERE created_at > ?`)
+                .get(now - 24 * 60 * 60 * 1000)?.cnt ?? 0;
+            const last7dCount = this.#db
+                .prepare(`SELECT COUNT(*) as cnt FROM lifecycle_transition_events WHERE created_at > ?`)
+                .get(now - 7 * 24 * 60 * 60 * 1000)?.cnt ?? 0;
+            const triggerRows = this.#db
+                .prepare(`SELECT trigger, COUNT(*) as cnt
+           FROM lifecycle_transition_events
+           WHERE created_at > ?
+           GROUP BY trigger
+           ORDER BY cnt DESC
+           LIMIT 5`)
+                .all(now - 7 * 24 * 60 * 60 * 1000);
+            return {
+                last24h: last24hCount,
+                last7d: last7dCount,
+                topTriggers: triggerRows.map((r) => ({ trigger: r.trigger, count: r.cnt })),
+            };
+        }
+        catch {
+            return { last24h: 0, last7d: 0, topTriggers: [] };
+        }
+    }
+    #getProposalMetrics() {
+        try {
+            const statusCounts = this.#db
+                .prepare(`SELECT status, COUNT(*) as cnt FROM evolution_proposals GROUP BY status`)
+                .all();
+            const map = {};
+            for (const row of statusCounts) {
+                map[row.status] = row.cnt;
+            }
+            const pending = map.pending ?? 0;
+            const observing = map.observing ?? 0;
+            const executed = map.executed ?? 0;
+            const rejected = map.rejected ?? 0;
+            const expired = map.expired ?? 0;
+            const total = executed + rejected + expired;
+            // contentPatchRate: 有 patch 的事件 / 总 proposal-execution 事件
+            let contentPatchRate = 0;
+            try {
+                const patchEvents = this.#db
+                    .prepare(`SELECT COUNT(*) as cnt FROM lifecycle_transition_events
+             WHERE trigger = 'content-patch-complete'`)
+                    .get();
+                const execEvents = this.#db
+                    .prepare(`SELECT COUNT(*) as cnt FROM lifecycle_transition_events
+             WHERE trigger = 'proposal-execution' OR trigger = 'proposal-attach'`)
+                    .get();
+                const patchCount = patchEvents?.cnt ?? 0;
+                const execCount = execEvents?.cnt ?? 0;
+                contentPatchRate = execCount > 0 ? patchCount / execCount : 0;
+            }
+            catch {
+                // table may not exist yet
+            }
+            return {
+                pendingCount: pending,
+                observingCount: observing,
+                executionRate: total > 0 ? executed / total : 0,
+                avgObservationDays: 0, // TODO: calculate from resolved proposals
+                contentPatchRate,
+            };
+        }
+        catch {
+            return {
+                pendingCount: 0,
+                observingCount: 0,
+                executionRate: 0,
+                avgObservationDays: 0,
+                contentPatchRate: 0,
+            };
+        }
+    }
+    /* ═══════════════════ DB Helpers ═══════════════════ */
+    #getRecipeState(recipeId) {
+        const row = this.#db
+            .prepare(`SELECT lifecycle FROM knowledge_entries WHERE id = ?`)
+            .get(recipeId);
+        return row ?? null;
+    }
+    #getRecipeAge(recipeId, now) {
+        const row = this.#db
+            .prepare(`SELECT updatedAt FROM knowledge_entries WHERE id = ?`)
+            .get(recipeId);
+        return row ? now - row.updatedAt : 0;
+    }
+    #rowToEvent(row) {
+        return {
+            id: row.id,
+            recipeId: row.recipe_id,
+            fromState: row.from_state,
+            toState: row.to_state,
+            trigger: row.trigger,
+            evidence: row.evidence_json ? safeJsonParse(row.evidence_json, null) : null,
+            proposalId: row.proposal_id ?? null,
+            operatorId: row.operator_id,
+            createdAt: row.created_at,
+        };
+    }
+    /* ═══════════════════ Signal ═══════════════════ */
+    #emitSignal(recipeId, fromState, toState, trigger) {
+        if (!this.#signalBus) {
+            return;
+        }
+        this.#signalBus.send('lifecycle', 'RecipeLifecycleSupervisor', 0.5, {
+            target: recipeId,
+            metadata: {
+                fromState,
+                toState,
+                trigger,
+            },
+        });
+    }
+}
+/* ────────────────────── Util ────────────────────── */
+function safeJsonParse(json, fallback) {
+    if (!json) {
+        return fallback;
+    }
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return fallback;
+    }
+}