principles-disciple 1.8.1 → 1.8.3

package/dist/service/empathy-observer-manager.js

@@ -1,414 +0,0 @@
-import { WorkspaceContext } from '../core/workspace-context.js';
-import { trackFriction } from '../core/session-tracker.js';
-import { isSubagentRuntimeAvailable } from '../utils/subagent-probe.js';
-const OBSERVER_SESSION_PREFIX = 'agent:main:subagent:empathy-obs-';
-// Default timeout for waitForRun (30 seconds)
-const DEFAULT_WAIT_TIMEOUT_MS = 30_000;
-export class EmpathyObserverManager {
-    static instance;
-    sessionLocks = new Map();
-    activeRuns = new Map();
-    completedSessions = new Map();
-    constructor() { }
-    static getInstance() {
-        if (!EmpathyObserverManager.instance) {
-            EmpathyObserverManager.instance = new EmpathyObserverManager();
-        }
-        return EmpathyObserverManager.instance;
-    }
-    /**
-     * Build a safe session key for empathy observer
-     * Format: agent:main:subagent:empathy-obs-{safeParentSessionId}-{timestamp}
-     */
-    buildEmpathyObserverSessionKey(parentSessionId) {
-        const safeParentSessionId = parentSessionId
-            .replace(/[^a-zA-Z0-9_-]/g, '_')
-            .substring(0, 64);
-        const timestamp = Date.now();
-        return `${OBSERVER_SESSION_PREFIX}${safeParentSessionId}-${timestamp}`;
-    }
-    /**
-     * Check if a session key is an empathy observer session
-     */
-    isObserverSession(sessionKey) {
-        return isEmpathyObserverSession(sessionKey);
-    }
-    markCompleted(observerSessionKey) {
-        this.completedSessions.set(observerSessionKey, Date.now());
-    }
-    isCompleted(observerSessionKey) {
-        const timestamp = this.completedSessions.get(observerSessionKey);
-        if (!timestamp)
-            return false;
-        if (Date.now() - timestamp > 5 * 60 * 1000) {
-            this.completedSessions.delete(observerSessionKey);
-            return false;
-        }
-        return true;
-    }
-    isActive(parentSessionId) {
-        const metadata = this.activeRuns.get(parentSessionId);
-        if (!metadata)
-            return false;
-        if (metadata.timedOutAt || metadata.erroredAt) {
-            if (!metadata.observedAt)
-                return true;
-            // TTL-based cleanup of orphaned timed-out/error entries:
-            // if fallback never fired, expire the block so parent session recovers
-            if (Date.now() - metadata.observedAt > 5 * 60 * 1000) {
-                this.activeRuns.delete(parentSessionId);
-                if (this.sessionLocks.get(parentSessionId) === metadata.observerSessionKey) {
-                    this.sessionLocks.delete(parentSessionId);
-                }
-                return false;
-            }
-            return true;
-        }
-        if (Date.now() - metadata.startedAt > 5 * 60 * 1000) {
-            this.activeRuns.delete(parentSessionId);
-            if (this.sessionLocks.get(parentSessionId) === metadata.observerSessionKey) {
-                this.sessionLocks.delete(parentSessionId);
-            }
-            return false;
-        }
-        return true;
-    }
-    getActiveMetadata(parentSessionId) {
-        return this.activeRuns.get(parentSessionId);
-    }
-    shouldTrigger(api, sessionId) {
-        if (!api || !sessionId) {
-            api?.logger?.warn?.('[PD:EmpathyObserver] shouldTrigger=false: api or sessionId null');
-            return false;
-        }
-        const enabled = api.config?.empathy_engine?.enabled !== false;
-        if (!enabled) {
-            api.logger?.warn?.('[PD:EmpathyObserver] shouldTrigger=false: empathy_engine disabled');
-            return false;
-        }
-        // Skip BOOT sessions - they run outside "gateway request" context where subagent.run() is unavailable
-        if (sessionId.startsWith('boot-')) {
-            api.logger?.warn?.('[PD:EmpathyObserver] shouldTrigger=false: boot session (gateway request context unavailable)');
-            return false;
-        }
-        const subagentOk = isSubagentRuntimeAvailable(api.runtime?.subagent);
-        if (!subagentOk) {
-            api.logger?.warn?.('[PD:EmpathyObserver] shouldTrigger=false: subagent runtime unavailable');
-            return false;
-        }
-        if (this.isActive(sessionId)) {
-            api.logger?.warn?.(`[PD:EmpathyObserver] shouldTrigger=false: session ${sessionId} has active run`);
-            return false;
-        }
-        api.logger?.info?.(`[PD:EmpathyObserver] shouldTrigger=true for session ${sessionId}`);
-        return true;
-    }
-    async spawn(api, sessionId, userMessage, workspaceDir) {
-        if (!api)
-            return null;
-        if (!this.shouldTrigger(api, sessionId)) {
-            api?.logger?.warn?.(`[PD:EmpathyObserver] spawn skipped: shouldTrigger=false for session ${sessionId}`);
-            return null;
-        }
-        if (!userMessage?.trim()) {
-            api?.logger?.warn?.('[PD:EmpathyObserver] spawn skipped: empty userMessage');
-            return null;
-        }
-        const sessionKey = this.buildEmpathyObserverSessionKey(sessionId);
-        this.sessionLocks.set(sessionId, sessionKey);
-        api.logger.info(`[PD:EmpathyObserver] Spawn starting for session ${sessionId}, key=${sessionKey}`);
-        const prompt = [
-            'You are an empathy observer.',
-            'Analyze ONLY the user message and return strict JSON (no markdown):',
-            '{"damageDetected": boolean, "severity": "mild|moderate|severe", "confidence": number, "reason": string}',
-            `User message: ${JSON.stringify(userMessage.trim())}`,
-        ].join('\n');
-        let runId;
-        try {
-            const result = await api.runtime.subagent.run({
-                sessionKey,
-                message: prompt,
-                lane: 'subagent',
-                deliver: false,
-                idempotencyKey: `${sessionId}:${Date.now()}`,
-                expectsCompletionMessage: true,
-            });
-            runId = result.runId;
-            api.logger.info(`[PD:EmpathyObserver] Spawn succeeded for ${sessionKey}, runId=${runId}`);
-        }
-        catch (error) {
-            this.sessionLocks.delete(sessionId);
-            api.logger.warn(`[PD:EmpathyObserver] Spawn failed for ${sessionId}: ${String(error)}`);
-            return null;
-        }
-        this.activeRuns.set(sessionId, {
-            runId,
-            parentSessionId: sessionId,
-            observerSessionKey: sessionKey,
-            workspaceDir,
-            startedAt: Date.now(),
-        });
-        this.finalizeRun(api, sessionId, sessionKey, workspaceDir).catch(async (err) => {
-            api.logger.warn(`[PD:EmpathyObserver] finalizeRun failed (will retry once): ${String(err)}`);
-            await new Promise((r) => setTimeout(r, 2000));
-            try {
-                await this.finalizeRun(api, sessionId, sessionKey, workspaceDir);
-            }
-            catch (retryErr) {
-                api.logger.warn(`[PD:EmpathyObserver] finalizeRun retry also failed: ${String(retryErr)}`);
-            }
-        });
-        return sessionKey;
-    }
-    /**
-     * Main回收链路: 使用 waitForRun 驱动回收
-     * 仅在 ok 时回收; timeout/exception 保留 session 由 fallback 处理
-     */
-    async finalizeRun(api, parentSessionId, observerSessionKey, workspaceDir) {
-        const metadata = this.activeRuns.get(parentSessionId);
-        const runId = metadata?.runId;
-        if (!runId) {
-            api.logger.warn(`[PD:EmpathyObserver] finalizeRun: no runId for ${observerSessionKey}`);
-            this.cleanupState(parentSessionId, observerSessionKey);
-            return;
-        }
-        api.logger.info(`[PD:EmpathyObserver] finalizeRun: waiting for runId=${runId}`);
-        let waitResult;
-        try {
-            waitResult = await api.runtime.subagent.waitForRun({
-                runId,
-                timeoutMs: DEFAULT_WAIT_TIMEOUT_MS,
-            });
-            api.logger.info(`[PD:EmpathyObserver] finalizeRun: wait completed status=${waitResult.status}`);
-        }
-        catch (error) {
-            api.logger.warn(`[PD:EmpathyObserver] finalizeRun: waitForRun threw for ${runId}: ${String(error)}`);
-            const updatedMetadata = this.activeRuns.get(parentSessionId);
-            if (updatedMetadata) {
-                updatedMetadata.erroredAt = Date.now();
-                updatedMetadata.observedAt = Date.now();
-            }
-            this.cleanupState(parentSessionId, observerSessionKey, false);
-            return;
-        }
-        if (waitResult.status === 'timeout') {
-            api.logger.warn(`[PD:EmpathyObserver] finalizeRun: observer wait timed out; deferring cleanup for ${observerSessionKey}`);
-            const updatedMetadata = this.activeRuns.get(parentSessionId);
-            if (updatedMetadata) {
-                updatedMetadata.timedOutAt = Date.now();
-                updatedMetadata.observedAt = Date.now();
-            }
-            this.cleanupState(parentSessionId, observerSessionKey, false);
-            return;
-        }
-        if (waitResult.status === 'error') {
-            api.logger.warn(`[PD:EmpathyObserver] finalizeRun: observer run errored: ${waitResult.error}; deferring cleanup for ${observerSessionKey}`);
-            const updatedMetadata = this.activeRuns.get(parentSessionId);
-            if (updatedMetadata) {
-                updatedMetadata.erroredAt = Date.now();
-                updatedMetadata.observedAt = Date.now();
-            }
-            this.cleanupState(parentSessionId, observerSessionKey, false);
-            return;
-        }
-        // Set observedAt before reapBySession so TTL cleanup works even if reapBySession fails
-        const updatedMetadata = this.activeRuns.get(parentSessionId);
-        if (updatedMetadata) {
-            updatedMetadata.observedAt = Date.now();
-        }
-        await this.reapBySession(api, observerSessionKey, parentSessionId, workspaceDir);
-    }
-    /**
-     * 统一回收入口: reap + deleteSession + 清理状态
-     */
-    async reapBySession(api, observerSessionKey, parentSessionId, workspaceDir) {
-        if (this.isCompleted(observerSessionKey)) {
-            api.logger.info(`[PD:EmpathyObserver] reapBySession: already processed ${observerSessionKey}, skipping`);
-            this.cleanupState(parentSessionId, observerSessionKey);
-            return;
-        }
-        api.logger.info(`[PD:EmpathyObserver] reapBySession starting for ${observerSessionKey}`);
-        const storedMetadata = this.activeRuns.get(parentSessionId);
-        // Use original parentSessionId from metadata, NOT extracted from session key
-        // (session key may have been sanitized/truncated and doesn't match original)
-        const sessionId = storedMetadata?.parentSessionId || this.extractParentSessionId(observerSessionKey) || parentSessionId;
-        let finalized = false;
-        try {
-            const messages = await api.runtime.subagent.getSessionMessages({
-                sessionKey: observerSessionKey,
-                limit: 20,
-            });
-            api.logger.info(`[PD:EmpathyObserver] Retrieved messages for ${observerSessionKey}`);
-            const rawText = this.extractAssistantText(messages.messages, messages.assistantTexts);
-            api.logger?.debug?.(`[PD:EmpathyObserver] Raw observer output for ${observerSessionKey}: ${JSON.stringify(rawText)}`);
-            const parsed = this.parseJsonPayload(rawText, api.logger);
-            api.logger.info(`[PD:EmpathyObserver] Payload parsed: ${JSON.stringify(parsed)}`);
-            if (parsed?.damageDetected && sessionId) {
-                const wctx = WorkspaceContext.fromHookContext({ workspaceDir: workspaceDir || '' });
-                const score = this.scoreFromSeverity(parsed.severity, wctx.config);
-                trackFriction(sessionId, score, `observer_empathy_${parsed.severity || 'mild'}`, workspaceDir || '', { source: 'user_empathy' });
-                const eventId = `emp_obs_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
-                wctx.eventLog.recordPainSignal(sessionId, {
-                    score,
-                    source: 'user_empathy',
-                    reason: parsed.reason || 'Empathy observer detected likely user frustration.',
-                    isRisky: false,
-                    origin: 'system_infer',
-                    severity: this.normalizeSeverity(parsed.severity),
-                    confidence: this.normalizeConfidence(parsed.confidence),
-                    detection_mode: 'structured',
-                    deduped: false,
-                    trigger_text_excerpt: rawText.substring(0, 120),
-                    raw_score: score,
-                    calibrated_score: score,
-                    eventId,
-                });
-                try {
-                    wctx.trajectory?.recordPainEvent?.({
-                        sessionId,
-                        source: 'user_empathy',
-                        score,
-                        reason: parsed.reason || 'Empathy observer detected likely user frustration.',
-                        severity: this.normalizeSeverity(parsed.severity),
-                        origin: 'system_infer',
-                        confidence: this.normalizeConfidence(parsed.confidence),
-                    });
-                }
-                catch (error) {
-                    api.logger.warn(`[PD:EmpathyObserver] Failed to persist observer pain event for ${sessionId}: ${String(error)}`);
-                }
-                api.logger.info(`[PD:EmpathyObserver] Applied GFI +${score} for ${sessionId}`);
-            }
-            else {
-                api.logger.info(`[PD:EmpathyObserver] No damage detected or no sessionId for ${observerSessionKey}`);
-            }
-            finalized = true;
-        }
-        catch (error) {
-            api.logger.warn(`[PD:EmpathyObserver] reapBySession failed to read messages for ${observerSessionKey}: ${String(error)}`);
-        }
-        // Only delete the session if we successfully read messages (finalized=true).
-        // When finalized=false (getSessionMessages failed), preserve the session so
-        // the subagent_ended fallback can retry or the TTL expiry can unblock the parent.
-        if (finalized) {
-            try {
-                await api.runtime.subagent.deleteSession({ sessionKey: observerSessionKey });
-                api.logger.info(`[PD:EmpathyObserver] deleteSession succeeded for ${observerSessionKey}`);
-            }
-            catch (error) {
-                api.logger.warn(`[PD:EmpathyObserver] deleteSession failed for ${observerSessionKey}: ${String(error)}`);
-            }
-            this.markCompleted(observerSessionKey);
-        }
-        // Only delete from activeRuns if finalized; otherwise preserve entry for subagent_ended fallback
-        this.cleanupState(parentSessionId, observerSessionKey, finalized);
-    }
-    /**
-     * Fallback回收: 由 subagent_ended 触发
-     * 仅在主链路未处理时执行补救回收
-     */
-    async reap(api, targetSessionKey, workspaceDir) {
-        if (!api || !this.isObserverSession(targetSessionKey))
-            return;
-        if (this.isCompleted(targetSessionKey)) {
-            api.logger.info(`[PD:EmpathyObserver] reap fallback: already processed ${targetSessionKey}, skipping`);
-            return;
-        }
-        // Find the original parentSessionId by matching observerSessionKey in activeRuns
-        // (the session key may have been sanitized, so we can't rely on extraction alone)
-        let parentSessionId = '';
-        for (const [key, metadata] of this.activeRuns) {
-            if (metadata.observerSessionKey === targetSessionKey) {
-                parentSessionId = key;
-                break;
-            }
-        }
-        // Fallback: extract from session key (may be truncated but better than nothing for logging)
-        if (!parentSessionId) {
-            parentSessionId = this.extractParentSessionId(targetSessionKey) || '';
-        }
-        await this.reapBySession(api, targetSessionKey, parentSessionId, workspaceDir);
-    }
-    cleanupState(parentSessionId, observerSessionKey, deleteFromActiveRuns = true) {
-        if (deleteFromActiveRuns) {
-            this.activeRuns.delete(parentSessionId);
-        }
-        if (this.sessionLocks.get(parentSessionId) === observerSessionKey) {
-            this.sessionLocks.delete(parentSessionId);
-        }
-    }
-    /**
-     * Extract parent session ID from observer session key
-     */
-    extractParentSessionId(sessionKey) {
-        if (!this.isObserverSession(sessionKey))
-            return null;
-        const match = sessionKey.match(/empathy-obs-(.+)-(\d+)$/);
-        return match ? match[1] : null;
-    }
-    parseJsonPayload(rawText, logger) {
-        if (!rawText?.trim())
-            return null;
-        try {
-            return JSON.parse(rawText.trim());
-        }
-        catch {
-            const match = rawText.match(/\{[\s\S]*\}/);
-            if (!match) {
-                logger?.warn('[PD:EmpathyObserver] Observer payload is not valid JSON, skipping.');
-                return null;
-            }
-            try {
-                return JSON.parse(match[0]);
-            }
-            catch {
-                logger?.warn('[PD:EmpathyObserver] Failed to parse observer JSON payload, skipping.');
-                return null;
-            }
-        }
-    }
-    extractAssistantText(messages, assistantTexts) {
-        if (assistantTexts && assistantTexts.length > 0) {
-            return assistantTexts[assistantTexts.length - 1] || '';
-        }
-        for (let i = messages.length - 1; i >= 0; i--) {
-            const msg = messages[i];
-            if (msg?.role !== 'assistant')
-                continue;
-            if (typeof msg.content === 'string')
-                return msg.content;
-            if (Array.isArray(msg.content)) {
-                const txt = msg.content
-                    .filter((part) => part?.type === 'text' && typeof part.text === 'string')
-                    .map((part) => part.text)
-                    .join('\n');
-                if (txt)
-                    return txt;
-            }
-        }
-        return '';
-    }
-    scoreFromSeverity(severity, config) {
-        if (severity === 'severe')
-            return Number(config.get('empathy_engine.penalties.severe') ?? 40);
-        if (severity === 'moderate')
-            return Number(config.get('empathy_engine.penalties.moderate') ?? 25);
-        return Number(config.get('empathy_engine.penalties.mild') ?? 10);
-    }
-    normalizeSeverity(severity) {
-        if (severity === 'severe')
-            return 'severe';
-        if (severity === 'moderate')
-            return 'moderate';
-        return 'mild';
-    }
-    normalizeConfidence(value) {
-        if (!Number.isFinite(value))
-            return 1;
-        return Math.max(0, Math.min(1, Number(value)));
-    }
-}
-export const empathyObserverManager = EmpathyObserverManager.getInstance();
-export function isEmpathyObserverSession(sessionKey) {
-    return typeof sessionKey === 'string' && sessionKey.startsWith(OBSERVER_SESSION_PREFIX);
-}

package/dist/service/evolution-query-service.d.ts

@@ -1,155 +0,0 @@
-/**
- * EvolutionQueryService - 进化流程查询服务
- *
- * 提供 WebUI 所需的查询 API：
- * - getTasks() - 获取任务列表
- * - getEvents() - 获取事件流
- * - getTrace() - 获取完整追踪
- * - getStats() - 获取统计数据
- */
-import type { TrajectoryDatabase } from '../core/trajectory.js';
-export interface TaskListFilters {
-    status?: string;
-    dateFrom?: string;
-    dateTo?: string;
-    page?: number;
-    pageSize?: number;
-}
-export interface EventFilters {
-    traceId?: string;
-    stage?: string;
-    limit?: number;
-    offset?: number;
-}
-export interface TasksResponse {
-    items: Array<{
-        taskId: string;
-        traceId: string;
-        source: string;
-        reason: string | null;
-        score: number;
-        status: string;
-        enqueuedAt: string | null;
-        startedAt: string | null;
-        completedAt: string | null;
-        duration: number | null;
-        resolution: string | null;
-        eventCount: number;
-        createdAt: string;
-    }>;
-    pagination: {
-        page: number;
-        pageSize: number;
-        total: number;
-        totalPages: number;
-    };
-}
-export interface EventsResponse {
-    items: Array<{
-        id: number;
-        traceId: string;
-        taskId: string | null;
-        stage: string;
-        stageLabel: string;
-        stageColor: string;
-        level: string;
-        message: string;
-        summary: string | null;
-        metadata: Record<string, unknown>;
-        createdAt: string;
-    }>;
-    pagination: {
-        limit: number;
-        offset: number;
-        hasMore: boolean;
-    };
-}
-export interface TraceDetailResponse {
-    traceId: string;
-    task: {
-        taskId: string;
-        traceId: string;
-        source: string;
-        reason: string | null;
-        score: number;
-        status: string;
-        enqueuedAt: string | null;
-        startedAt: string | null;
-        completedAt: string | null;
-        duration: number | null;
-        resolution: string | null;
-        createdAt: string;
-        updatedAt: string;
-    };
-    events: Array<{
-        id: number;
-        traceId: string;
-        taskId: string | null;
-        stage: string;
-        stageLabel: string;
-        stageColor: string;
-        level: string;
-        message: string;
-        summary: string | null;
-        metadata: Record<string, unknown>;
-        createdAt: string;
-    }>;
-    timeline: Array<{
-        stage: string;
-        stageLabel: string;
-        stageColor: string;
-        timestamp: string;
-        message: string;
-        summary: string | null;
-    }>;
-}
-export interface EvolutionStatsResponse {
-    total: number;
-    pending: number;
-    inProgress: number;
-    completed: number;
-    failed: number;
-    recentActivity: Array<{
-        day: string;
-        created: number;
-        completed: number;
-    }>;
-    stageDistribution: Array<{
-        stage: string;
-        stageLabel: string;
-        count: number;
-    }>;
-}
-/**
- * EvolutionQueryService 类
- * 封装进化流程的查询逻辑
- */
-export declare class EvolutionQueryService {
-    private readonly trajectory;
-    constructor(trajectory: TrajectoryDatabase);
-    /**
-     * 释放资源
-     * 注意：不关闭 trajectory，因为它是单例由 TrajectoryRegistry 管理
-     */
-    dispose(): void;
-    /**
-     * 获取任务列表（带分页、筛选）
-     */
-    getTasks(filters?: TaskListFilters): TasksResponse;
-    /**
-     * 获取事件流
-     */
-    getEvents(filters?: EventFilters): EventsResponse;
-    /**
-     * 获取完整追踪（单个 trace 的所有事件）
-     */
-    getTrace(traceId: string): TraceDetailResponse | null;
-    /**
-     * 获取统计数据
-     */
-    getStats(days?: number): EvolutionStatsResponse;
-}
-/**
- * 获取 EvolutionQueryService 实例（单例）
- */
-export declare function getEvolutionQueryService(trajectory: TrajectoryDatabase): EvolutionQueryService;