principles-disciple 1.7.0 → 1.7.1

package/dist/commands/evolution-status.js

@@ -1,138 +1,134 @@
 import { EvolutionReducerImpl } from '../core/evolution-reducer.js';
 import { normalizeLanguage } from '../i18n/commands.js';
-import { getAgentScorecard } from '../core/trust-engine.js';
-import { EventLogService } from '../core/event-log.js';
-import * as fs from 'fs';
-import * as path from 'path';
-function getQueueStats(workspaceDir) {
-    const stateDir = path.join(workspaceDir, '.state', 'principles');
-    const queuePath = path.join(stateDir, 'evolution_queue.json');
-    let pending = 0;
-    let completed = 0;
-    let inProgress = 0;
-    try {
-        if (fs.existsSync(queuePath)) {
-            const queue = JSON.parse(fs.readFileSync(queuePath, 'utf-8'));
-            for (const item of queue) {
-                if (item.status === 'completed') {
-                    completed++;
-                }
-                else if (item.status === 'in_progress') {
-                    inProgress++;
-                }
-                else {
-                    pending++;
-                }
-            }
-        }
+import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
+function formatAge(ageSeconds, lang) {
+    if (ageSeconds === null) {
+        return '--';
     }
-    catch {
-        // Ignore errors, return zeros
+    if (ageSeconds < 60) {
+        return lang === 'zh' ? `${ageSeconds} \u79d2` : `${ageSeconds}s`;
     }
-    return { pending, completed, inProgress };
-}
-function getCurrentPain(workspaceDir) {
-    const stateDir = path.join(workspaceDir, '.state', 'principles');
-    const painFlagPath = path.join(stateDir, '.pain_flag');
-    try {
-        if (fs.existsSync(painFlagPath)) {
-            const data = JSON.parse(fs.readFileSync(painFlagPath, 'utf-8'));
-            return {
-                painScore: data.score || 0,
-                painSource: data.source || 'none'
-            };
-        }
+    const minutes = Math.floor(ageSeconds / 60);
+    if (minutes < 60) {
+        return lang === 'zh' ? `${minutes} \u5206\u949f` : `${minutes}m`;
     }
-    catch {
-        // Ignore errors
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24) {
+        return lang === 'zh' ? `${hours} \u5c0f\u65f6` : `${hours}h`;
     }
-    return { painScore: 0, painSource: 'none' };
+    const days = Math.floor(hours / 24);
+    return lang === 'zh' ? `${days} \u5929` : `${days}d`;
 }
-export function handleEvolutionStatusCommand(ctx) {
-    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
-    const reducer = new EvolutionReducerImpl({ workspaceDir });
-    const stats = reducer.getStats();
-    // Get Trust Score
-    let trustScore = 0;
-    let trustStage = 1;
-    try {
-        const scorecard = getAgentScorecard(workspaceDir);
-        trustScore = scorecard.trust_score ?? 0;
-        trustStage = trustScore >= 80 ? 4 : trustScore >= 60 ? 3 : trustScore >= 30 ? 2 : 1;
-    }
-    catch {
-        // Ignore errors, use defaults
-    }
-    // Get EventLog for GFI and Pain stats
-    let gfiPeak = 0;
-    let painSignals = 0;
-    try {
-        const stateDir = path.join(workspaceDir, '.state', 'principles');
-        const eventLog = EventLogService.get(stateDir);
-        const today = new Date().toISOString().split('T')[0];
-        const dailyStats = eventLog.getDailyStats(today);
-        gfiPeak = dailyStats.gfi?.peak ?? 0;
-        painSignals = dailyStats.pain?.signalsDetected ?? 0;
-    }
-    catch {
-        // Ignore errors, use defaults
+function formatNumber(value) {
+    if (value === null || Number.isNaN(value)) {
+        return '--';
     }
-    // Get Queue Stats
-    const queueStats = getQueueStats(workspaceDir);
-    // Get Current Pain
-    const currentPain = getCurrentPain(workspaceDir);
-    // Determine language - handle both 'zh' and 'zh-CN' formats
-    const rawLang = ctx.config?.language || 'en';
-    const lang = normalizeLanguage(rawLang);
-    if (lang === 'zh') {
-        const lines = [
-            '📈 Evolution 状态',
-            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
-            '',
-            `🛡️ Trust Score: ${trustScore}/100 (Stage ${trustStage})`,
-            `😴 GFI Peak: ${gfiPeak.toFixed(1)}`,
-            `⚡ Current Pain: ${currentPain.painScore} pts (${currentPain.painSource})`,
-            `📈 Pain Signals Today: ${painSignals}`,
-            '',
-            '📊 Evolution Rules',
-            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
-            `- 候选原则: ${stats.candidateCount}`,
-            `- 观察期原则: ${stats.probationCount}`,
-            `- 生效原则: ${stats.activeCount}`,
-            `- 已废弃原则: ${stats.deprecatedCount}`,
-            `- 最近晋升时间: ${stats.lastPromotedAt ?? '无'}`,
-            '',
-            '📋 Evolution Queue',
-            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
-            `- 待处理: ${queueStats.pending} 项`,
-            `- 进行中: ${queueStats.inProgress} 项`,
-            `- 已完成: ${queueStats.completed} 项`,
-        ];
-        return { text: lines.join('\n') };
+    return Number.isInteger(value) ? String(value) : value.toFixed(1);
+}
+function formatStage(value) {
+    return value === null ? '--' : String(value);
+}
+function formatSources(sources) {
+    if (sources.length === 0) {
+        return '--';
     }
-    // English
+    return sources
+        .map((source) => source.score === undefined
+        ? source.source
+        : `${source.source}(${formatNumber(source.score)})`)
+        .join(', ');
+}
+function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary) {
     const lines = [
-        '📈 Evolution Status',
-        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+        'Evolution Status',
+        '================',
+        '',
+        'Control Plane',
+        `- Legacy Trust: ${formatNumber(summary.legacyTrust.score)}/100 (stage ${formatStage(summary.legacyTrust.stage)}, legacy/frozen, ${summary.legacyTrust.rewardPolicy})`,
+        `- Session GFI: current ${formatNumber(summary.gfi.current)}, peak ${formatNumber(summary.gfi.peak)} (${summary.gfi.dataQuality})`,
+        `- GFI Sources: ${formatSources(summary.gfi.sources)}`,
+        `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? ` (${summary.pain.activeFlagSource})` : ''}`,
+        `- Last Pain Signal: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
+        `- Gate Events: blocks ${formatNumber(summary.gate.recentBlocks)}, bypasses ${formatNumber(summary.gate.recentBypasses)} (${summary.gate.dataQuality})`,
         '',
-        `🛡️ Trust Score: ${trustScore}/100 (Stage ${trustStage})`,
-        `😴 GFI Peak: ${gfiPeak.toFixed(1)}`,
-        `⚡ Current Pain: ${currentPain.painScore} pts (${currentPain.painSource})`,
-        `📈 Pain Signals Today: ${painSignals}`,
+        'Evolution',
+        `- Queue: pending ${summary.evolution.queue.pending}, in_progress ${summary.evolution.queue.inProgress}, completed ${summary.evolution.queue.completed} (${summary.evolution.dataQuality})`,
+        `- Directive: ${summary.evolution.directive.exists ? 'present' : 'missing'}, active ${summary.evolution.directive.active === null ? '--' : summary.evolution.directive.active ? 'yes' : 'no'}, age ${formatAge(summary.evolution.directive.ageSeconds, 'en')}`,
+        `- Directive Task: ${summary.evolution.directive.taskPreview ?? '--'}`,
         '',
-        '📊 Evolution Rules',
-        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+        'Principles',
         `- candidate principles: ${stats.candidateCount}`,
         `- probation principles: ${stats.probationCount}`,
         `- active principles: ${stats.activeCount}`,
         `- deprecated principles: ${stats.deprecatedCount}`,
         `- last promoted: ${stats.lastPromotedAt ?? 'none'}`,
         '',
-        '📋 Evolution Queue',
-        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
-        `- Pending: ${queueStats.pending}`,
-        `- In Progress: ${queueStats.inProgress}`,
-        `- Completed: ${queueStats.completed}`,
+        'Metadata',
+        `- workspace: ${workspaceDir}`,
+        `- session: ${sessionId ?? '--'} (${summary.metadata.selectedSessionReason})`,
+        `- generatedAt: ${summary.metadata.generatedAt}`,
     ];
-    return { text: lines.join('\n') };
+    if (warnings.length > 0) {
+        lines.push('', 'Warnings');
+        for (const warning of warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    return lines.join('\n');
+}
+function buildChineseOutput(workspaceDir, sessionId, warnings, stats, summary) {
+    const lines = [
+        '\u8fdb\u5316\u72b6\u6001',
+        '================',
+        '',
+        '\u63a7\u5236\u9762',
+        `- Legacy Trust: ${formatNumber(summary.legacyTrust.score)}/100\uff08\u9636\u6bb5 ${formatStage(summary.legacyTrust.stage)}\uff0clegacy/frozen\uff0c${summary.legacyTrust.rewardPolicy}\uff09`,
+        `- \u4f1a\u8bdd GFI: \u5f53\u524d ${formatNumber(summary.gfi.current)}\uff0c\u5cf0\u503c ${formatNumber(summary.gfi.peak)}\uff08${summary.gfi.dataQuality}\uff09`,
+        `- GFI \u6765\u6e90: ${formatSources(summary.gfi.sources)}`,
+        `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? `\uff08${summary.pain.activeFlagSource}\uff09` : ''}`,
+        `- \u6700\u8fd1 Pain \u4fe1\u53f7: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
+        `- Gate \u4e8b\u4ef6: block ${formatNumber(summary.gate.recentBlocks)}\uff0cbypass ${formatNumber(summary.gate.recentBypasses)}\uff08${summary.gate.dataQuality}\uff09`,
+        '',
+        '\u8fdb\u5316',
+        `- \u961f\u5217: pending ${summary.evolution.queue.pending}\uff0cin_progress ${summary.evolution.queue.inProgress}\uff0ccompleted ${summary.evolution.queue.completed}\uff08${summary.evolution.dataQuality}\uff09`,
+        `- Directive: ${summary.evolution.directive.exists ? 'present' : 'missing'}\uff0cactive ${summary.evolution.directive.active === null ? '--' : summary.evolution.directive.active ? 'yes' : 'no'}\uff0cage ${formatAge(summary.evolution.directive.ageSeconds, 'zh')}`,
+        `- Directive \u4efb\u52a1: ${summary.evolution.directive.taskPreview ?? '--'}`,
+        '',
+        '\u539f\u5219\u7edf\u8ba1',
+        `- \u5019\u9009\u539f\u5219: ${stats.candidateCount}`,
+        `- \u89c2\u5bdf\u671f\u539f\u5219: ${stats.probationCount}`,
+        `- \u751f\u6548\u539f\u5219: ${stats.activeCount}`,
+        `- \u5df2\u5e9f\u5f03\u539f\u5219: ${stats.deprecatedCount}`,
+        `- \u6700\u8fd1\u664b\u5347: ${stats.lastPromotedAt ?? '\u65e0'}`,
+        '',
+        '\u5143\u6570\u636e',
+        `- \u5de5\u4f5c\u533a: ${workspaceDir}`,
+        `- Session: ${sessionId ?? '--'}\uff08${summary.metadata.selectedSessionReason}\uff09`,
+        `- \u751f\u6210\u65f6\u95f4: ${summary.metadata.generatedAt}`,
+    ];
+    if (warnings.length > 0) {
+        lines.push('', '警告');
+        for (const warning of warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function handleEvolutionStatusCommand(ctx) {
+    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+    const sessionId = ctx.sessionId ?? null;
+    const reducer = new EvolutionReducerImpl({ workspaceDir });
+    const stats = reducer.getStats();
+    const summary = RuntimeSummaryService.getSummary(workspaceDir, { sessionId });
+    const rawLang = ctx.config?.language || 'en';
+    const lang = normalizeLanguage(rawLang);
+    const warnings = summary.metadata.warnings.slice(0, 12);
+    if (lang === 'zh') {
+        return {
+            text: buildChineseOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary),
+        };
+    }
+    return {
+        text: buildEnglishOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary),
+    };
 }

package/dist/commands/rollback.js

@@ -63,7 +63,10 @@ Usage:
         };
     }
     // Reduce the GFI by the rolled back score
-    resetFriction(sessionId);
+    resetFriction(sessionId, workspaceDir, {
+        source: 'user_empathy',
+        amount: rolledBackScore,
+    });
     return {
         text: isZh
             ? `✅ 已回滚情绪事件
@@ -107,8 +110,11 @@ export function handleNaturalLanguageRollback(wctx, sessionId, reason) {
             message: isZh ? '回滚失败，事件可能不存在' : 'Rollback failed, event may not exist'
         };
     }
-    // Reduce the GFI
-    resetFriction(sessionId);
+    // Reduce only the empathy slice instead of wiping the whole session GFI.
+    resetFriction(sessionId, wctx.workspaceDir, {
+        source: 'user_empathy',
+        amount: rolledBackScore,
+    });
     return {
         success: true,
         score: rolledBackScore,

package/dist/commands/trust.js

@@ -1,11 +1,15 @@
 import { WorkspaceContext } from '../core/workspace-context.js';
-/**
- * Creates a visual progress bar (e.g., [██████░░░░])
- */
-function createProgressBar(value, max, length = 10) {
-    const filledLength = Math.round((value / max) * length);
-    const emptyLength = length - filledLength;
-    return `[${'█'.repeat(filledLength)}${'░'.repeat(emptyLength)}]`;
+function createProgressBar(value, max, length = 12) {
+    const safeValue = Math.max(0, Math.min(max, value));
+    const filledLength = Math.round((safeValue / max) * length);
+    const emptyLength = Math.max(0, length - filledLength);
+    return `[${'#'.repeat(filledLength)}${'-'.repeat(emptyLength)}]`;
+}
+function formatStageTitle(stage, isZh) {
+    const titles = isZh
+        ? ['Observer', 'Editor', 'Developer', 'Architect']
+        : ['Observer', 'Editor', 'Developer', 'Architect'];
+    return titles[Math.max(0, Math.min(3, stage - 1))] ?? 'Unknown';
 }
 export function handleTrustCommand(ctx) {
     const { workspaceDir } = ctx;
@@ -14,82 +18,61 @@ export function handleTrustCommand(ctx) {
     const wctx = WorkspaceContext.fromHookContext(ctx);
     const trustEngine = wctx.trust;
     const trustScore = trustEngine.getScore();
-    const trustSettings = wctx.config.get('trust');
+    const stage = trustEngine.getStage();
     const isZh = wctx.config.get('language') === 'zh';
-    let stage = 2;
-    let title = isZh ? '编辑者' : 'Editor';
-    let permissions = isZh
-        ? `- 允许小范围修改 (< ${trustSettings.limits.stage_2_max_lines} 行)\n- 禁止修改风险目录`
-        : `- Small modifications (< ${trustSettings.limits.stage_2_max_lines} lines)\n- Non-risk paths only`;
-    let nextLevel = `Trust Score >= ${trustSettings.stages.stage_3_developer}`;
-    if (trustScore < trustSettings.stages.stage_1_observer) {
-        stage = 1;
-        title = isZh ? '观察者 (只读模式)' : 'Observer (Read-only)';
-        permissions = isZh ? '- 仅限只读访问\n- 仅限诊断工具' : '- Read-only access\n- Diagnosis tools only';
-        nextLevel = `Trust Score >= ${trustSettings.stages.stage_1_observer}`;
-    }
-    else if (trustScore < trustSettings.stages.stage_2_editor) {
-        // Default stage 2
-        nextLevel = `Trust Score >= ${trustSettings.stages.stage_2_editor}`;
-    }
-    else if (trustScore < trustSettings.stages.stage_3_developer) {
-        stage = 3;
-        title = isZh ? '开发者' : 'Developer';
-        permissions = isZh
-            ? `- 允许中等范围修改 (< ${trustSettings.limits.stage_3_max_lines} 行)\n- 风险目录修改需要有 PLAN (计划)`
-            : `- Medium modifications (< ${trustSettings.limits.stage_3_max_lines} lines)\n- Risk paths require READY plan`;
-        nextLevel = `Trust Score >= ${trustSettings.stages.stage_3_developer}`;
-    }
-    else {
-        stage = 4;
-        title = isZh ? '架构师' : 'Architect';
-        permissions = isZh ? '- 🚨 **无限制访问**\n- 计划和审计非强制要求' : '- 🚨 **UNRESTRICTED access**\n- Plan and Audit are optional';
-        nextLevel = isZh ? '已达最高级' : 'MAX LEVEL REACHED';
-    }
-    const progressBar = createProgressBar(trustScore, 100, 15);
+    const scorecard = trustEngine.getScorecard();
     const hygiene = wctx.hygiene.getStats();
-    const persistenceScore = Math.min(100, hygiene.persistenceCount * 10); // 10 points per persistence
-    const hygieneBar = createProgressBar(persistenceScore, 100, 15);
+    const trustBar = createProgressBar(trustScore, 100);
+    const hygieneScore = Math.min(100, hygiene.persistenceCount * 10);
+    const hygieneBar = createProgressBar(hygieneScore, 100);
+    const rewardPolicy = scorecard.reward_policy ?? 'frozen_all_positive';
+    const lastUpdated = scorecard.last_updated ?? '--';
     if (isZh) {
-        return `
-📊 **Principles Disciple - 系统状态看板**
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🛡️ **安全阶级**: Stage ${stage} (${title})
-💰 **信任积分**: ${progressBar} ${trustScore}/100
-🧠 **认知卫生**: ${hygieneBar} ${hygiene.persistenceCount} 次落盘 (今日)
-
-**当前操作权限**:
-${permissions}
-
-**今日知识沉淀**:
-- 物理落盘: ${hygiene.persistenceCount} 次
-- 累计字符: ${hygiene.totalCharsPersisted} chars
-- 空间整理: ${hygiene.groomingExecutedCount > 0 ? '🟢 良好' : '🟡 待整理'}
-
-**下一次晋升条件**: ${nextLevel}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-*💡 提示：勤记笔记 (PLAN.md/memory) 有助于对抗上下文遗忘，提升系统稳定性。*
-`.trim();
-    }
-    else {
-        return `
-📊 **Principles Disciple - System Dashboard**
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🛡️ **Security Stage**: Stage ${stage} (${title})
-💰 **Trust Score**: ${progressBar} ${trustScore}/100
-🧠 **Cognitive Hygiene**: ${hygieneBar} ${hygiene.persistenceCount} actions (Today)
-
-**Current Permissions**:
-${permissions}
-
-**Knowledge Assets Today**:
-- Physical Persists: ${hygiene.persistenceCount} actions
-- Total Chars: ${hygiene.totalCharsPersisted} chars
-- Workspace Grooming: ${hygiene.groomingExecutedCount > 0 ? '🟢 Good' : '🟡 Pending'}
-
-**Next Promotion Requirement**: ${nextLevel}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-*💡 Hint: Frequent notes (PLAN.md/memory) prevent amnesia and ensure task continuity.*
-`.trim();
+        return [
+            'Principles Disciple - Legacy Trust',
+            '=================================',
+            '',
+            `- Legacy Trust: ${trustBar} ${trustScore}/100`,
+            `- Stage: ${stage} (${formatStageTitle(stage, true)})`,
+            `- Status: legacy/frozen`,
+            `- Reward Policy: ${rewardPolicy}`,
+            `- Last Updated: ${lastUpdated}`,
+            '',
+            '说明',
+            '- 这是兼容旧控制面的 legacy trust 视图，不再代表新的长期能力模型。',
+            '- `tool_success` 与 `subagent_success` 不再自动提升 trust。',
+            '- 当前观察窗口内，trust 主要保留为兼容读数与 gate 兼容输入。',
+            '',
+            '认知卫生',
+            `- Persistence: ${hygieneBar} ${hygiene.persistenceCount} actions today`,
+            `- Total Chars Persisted: ${hygiene.totalCharsPersisted}`,
+            `- Workspace Grooming: ${hygiene.groomingExecutedCount > 0 ? 'done' : 'pending'}`,
+            '',
+            '下一步',
+            '- 在进入 Phase 3 capability shadow 之前，先看 production observation 数据是否稳定。',
+        ].join('\n');
     }
+    return [
+        'Principles Disciple - Legacy Trust',
+        '=================================',
+        '',
+        `- Legacy Trust: ${trustBar} ${trustScore}/100`,
+        `- Stage: ${stage} (${formatStageTitle(stage, false)})`,
+        '- Status: legacy/frozen',
+        `- Reward Policy: ${rewardPolicy}`,
+        `- Last Updated: ${lastUpdated}`,
+        '',
+        'Notes',
+        '- This is a compatibility view of legacy trust, not the future long-term capability model.',
+        '- `tool_success` and `subagent_success` no longer raise trust automatically.',
+        '- During the current observation window, trust remains mainly for compatibility reads and gate compatibility.',
+        '',
+        'Cognitive Hygiene',
+        `- Persistence: ${hygieneBar} ${hygiene.persistenceCount} actions today`,
+        `- Total Chars Persisted: ${hygiene.totalCharsPersisted}`,
+        `- Workspace Grooming: ${hygiene.groomingExecutedCount > 0 ? 'done' : 'pending'}`,
+        '',
+        'Next',
+        '- Do not move into Phase 3 capability shadow until production observation data is stable.',
+    ].join('\n');
 }

package/dist/core/event-log.d.ts

@@ -1,4 +1,4 @@
-import type { DailyStats, EmpathyEventStats, ToolCallEventData, PainSignalEventData, RuleMatchEventData, RulePromotionEventData, HookExecutionEventData, GateBlockEventData, GateBypassEventData, PlanApprovalEventData, EvolutionTaskEventData, DeepReflectionEventData, TrustChangeEventData, EmpathyRollbackEventData } from '../types/event-types.js';
+import type { EventLogEntry, DailyStats, EmpathyEventStats, ToolCallEventData, PainSignalEventData, RuleMatchEventData, RulePromotionEventData, HookExecutionEventData, GateBlockEventData, GateBypassEventData, PlanApprovalEventData, EvolutionTaskEventData, DeepReflectionEventData, TrustChangeEventData, EmpathyRollbackEventData } from '../types/event-types.js';
 import type { PluginLogger } from '../openclaw-sdk.js';
 /**
  * EventLog - Structured event logging with daily statistics aggregation.
@@ -33,6 +33,11 @@ export declare class EventLog {
     private updateStats;
     private startFlushTimer;
     flush(): void;
+    /**
+     * Return in-memory buffered events that have not been flushed yet.
+     * Intended for live runtime summaries that should not lag behind disk snapshots.
+     */
+    getBufferedEvents(): EventLogEntry[];
     private flushEvents;
     private flushStats;
     /**

package/dist/core/event-log.js

@@ -169,6 +169,13 @@ export class EventLog {
         this.flushEvents();
         this.flushStats();
     }
+    /**
+     * Return in-memory buffered events that have not been flushed yet.
+     * Intended for live runtime summaries that should not lag behind disk snapshots.
+     */
+    getBufferedEvents() {
+        return this.eventBuffer.map((entry) => ({ ...entry, data: { ...entry.data } }));
+    }
     flushEvents() {
         if (this.eventBuffer.length === 0)
             return;

package/dist/core/session-tracker.d.ts

@@ -18,6 +18,8 @@ export interface SessionState {
     cacheHits: number;
     stuckLoops: number;
     currentGfi: number;
+    gfiBySource?: Record<string, number>;
+    lastErrorSource?: string;
     lastErrorHash: string;
     consecutiveErrors: number;
     dailyToolCalls: number;
@@ -41,11 +43,16 @@ export declare function trackLlmOutput(sessionId: string, usage: TokenUsage | un
 /**
  * Tracks physical friction based on tool execution failures.
  */
-export declare function trackFriction(sessionId: string, deltaF: number, hash: string, workspaceDir?: string): SessionState;
+export declare function trackFriction(sessionId: string, deltaF: number, hash: string, workspaceDir?: string, options?: {
+    source?: string;
+}): SessionState;
 /**
  * Resets the friction index upon successful action.
  */
-export declare function resetFriction(sessionId: string, workspaceDir?: string): SessionState;
+export declare function resetFriction(sessionId: string, workspaceDir?: string, options?: {
+    source?: string;
+    amount?: number;
+}): SessionState;
 /**
  * Records that deep thinking (Thinking OS) was performed in this session.
  * Used by the Thinking OS checkpoint to allow high-risk operations.
@@ -63,6 +70,7 @@ export declare function setInjectedProbationIds(sessionId: string, ids: string[]
 export declare function getInjectedProbationIds(sessionId: string, workspaceDir?: string): string[];
 export declare function clearInjectedProbationIds(sessionId: string, workspaceDir?: string): SessionState;
 export declare function getSession(sessionId: string): SessionState | undefined;
+export declare function listSessions(workspaceDir?: string): SessionState[];
 export declare function clearSession(sessionId: string): void;
 export declare function garbageCollectSessions(): void;
 /**