principles-disciple 1.8.1 → 1.8.3

package/{dist/commands/pain.js → src/commands/pain.ts}

@@ -1,32 +1,39 @@
-import { resetFriction, getSession } from '../core/session-tracker.js';
+import { trackFriction, resetFriction, getSession } from '../core/session-tracker.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import type { EmpathyEventStats } from '../types/event-types.js';
+
 /**
  * Creates a visual progress bar (e.g., [██████░░░░])
  */
-function createProgressBar(value, max, length = 10) {
+function createProgressBar(value: number, max: number, length: number = 10): string {
     const filledLength = Math.round((value / max) * length);
     const emptyLength = length - filledLength;
     return `[${'█'.repeat(filledLength)}${'░'.repeat(emptyLength)}]`;
 }
+
 /**
  * Creates a mini bar for daily trends
  */
-function createMiniBar(count, max, length = 6) {
+function createMiniBar(count: number, max: number, length: number = 6): string {
     const filledLength = Math.round((count / max) * length);
     return '█'.repeat(filledLength) + '░'.repeat(length - filledLength);
 }
+
 /**
  * Format empathy stats for display
  */
-function formatEmpathyCard(stats, range, isZh) {
+function formatEmpathyCard(stats: EmpathyEventStats, range: string, isZh: boolean): string {
     if (stats.totalEvents === 0 && stats.dedupedCount === 0) {
         return isZh
             ? `🫀 **情绪事件统计** (${range})\n   暂无数据`
             : `🫀 **Empathy Events** (${range})\n   No data available`;
     }
-    const lines = [];
+
+    const lines: string[] = [];
     lines.push(isZh ? `🫀 **情绪事件统计** (${range})` : `🫀 **Empathy Events** (${range})`);
     lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+
     // Total events
     const totalLabel = isZh ? '📊 总事件' : '📊 Total Events';
     lines.push(`${totalLabel}: ${stats.totalEvents} 次`);
@@ -34,6 +41,7 @@ function formatEmpathyCard(stats, range, isZh) {
     lines.push(`   ├─ 😠 moderate: ${stats.bySeverity.moderate} 次 (${stats.scoreBySeverity.moderate}分)`);
     lines.push(`   └─ 😡 severe: ${stats.bySeverity.severe} 次 (${stats.scoreBySeverity.severe}分)`);
     lines.push('');
+
     // Dedupe hit rate
     const dedupeRate = (stats.dedupeHitRate * 100).toFixed(0);
     const dedupeLabel = isZh ? '🔄 去重命中率' : '🔄 Dedupe Hit Rate';
@@ -42,12 +50,14 @@ function formatEmpathyCard(stats, range, isZh) {
         lines.push(isZh ? '   ↳ 避免了重复惩罚' : '   ↳ Prevented duplicate penalties');
     }
     lines.push('');
+
     // Rollback info
     if (stats.rollbackCount > 0) {
         const rollbackLabel = isZh ? '↩️ 已回滚' : '↩️ Rolled Back';
         lines.push(`${rollbackLabel}: ${stats.rollbackCount} 次 (${stats.rolledBackScore}分)`);
         lines.push('');
     }
+
     // Daily trend
     if (stats.dailyTrend.length > 1) {
         const trendLabel = isZh ? '📈 趋势 (按天)' : '📈 Trend (by day)';
@@ -59,28 +69,35 @@ function formatEmpathyCard(stats, range, isZh) {
             lines.push(`   ${dateStr}: ${bar} ${day.count}次`);
         }
     }
+
     // Detection mode distribution
     if (stats.byDetectionMode.structured > 0 || stats.byDetectionMode.legacy_tag > 0) {
         lines.push('');
         const modeLabel = isZh ? '🔍 检测模式' : '🔍 Detection Mode';
         lines.push(`${modeLabel}: 结构化 ${stats.byDetectionMode.structured} | 标签 ${stats.byDetectionMode.legacy_tag}`);
     }
+
     return lines.join('\n');
 }
+
 /**
  * Handles the /pd-status command
  */
-export function handlePainCommand(ctx) {
-    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResult {
+    const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+    
     const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-    const lang = ctx.config?.language || 'en';
+    const lang = (ctx.config?.language as string) || 'en';
     const isZh = lang === 'zh';
-    const sessionId = ctx.sessionId;
+    const sessionId = (ctx as any).sessionId;
+
     const args = (ctx.args || '').trim();
+
     // Handle empathy subcommand
     if (args.startsWith('empathy')) {
         return handleEmpathySubcommand(wctx, args, sessionId, isZh);
     }
+
     if (args === 'reset') {
         if (sessionId) {
             resetFriction(sessionId);
@@ -88,6 +105,7 @@ export function handlePainCommand(ctx) {
         }
         return { text: isZh ? `❌ 无法识别当前会话。` : `❌ Session ID not found. Use /pd-status reset in a chat session.` };
     }
+
     if (args === 'data') {
         const stats = wctx.trajectory.getDataStats();
         return {
@@ -96,33 +114,31 @@ export function handlePainCommand(ctx) {
                 : `Trajectory Data Status\n- DB: ${stats.dbPath}\n- assistant turns: ${stats.assistantTurns}\n- user turns: ${stats.userTurns}\n- tool calls: ${stats.toolCalls}\n- pain events: ${stats.painEvents}\n- pending samples: ${stats.pendingSamples}\n- approved samples: ${stats.approvedSamples}\n- blob bytes: ${stats.blobBytes}\n- last ingest: ${stats.lastIngestAt ?? 'none'}`
         };
     }
+
     // Default: Show status
     const session = sessionId ? getSession(sessionId) : undefined;
     const gfi = session ? session.currentGfi : 0;
     const dictionary = wctx.dictionary;
     const stats = dictionary.getStats();
+    
     const gfiBar = createProgressBar(gfi, 100, 15);
+    
     // Determine Mental Mode (aligned with prompt.ts logic)
     let mentalMode = '';
     if (isZh) {
-        if (gfi >= 70)
-            mentalMode = '🚑 救赎模式 (HUMBLE_RECOVERY)';
-        else if (gfi >= 40)
-            mentalMode = '🤝 安抚模式 (CONCILIATORY)';
-        else
-            mentalMode = '⚡ 高效模式 (EFFICIENT)';
-    }
-    else {
-        if (gfi >= 70)
-            mentalMode = '🚑 HUMBLE_RECOVERY';
-        else if (gfi >= 40)
-            mentalMode = '🤝 CONCILIATORY';
-        else
-            mentalMode = '⚡ EFFICIENT';
+        if (gfi >= 70) mentalMode = '🚑 救赎模式 (HUMBLE_RECOVERY)';
+        else if (gfi >= 40) mentalMode = '🤝 安抚模式 (CONCILIATORY)';
+        else mentalMode = '⚡ 高效模式 (EFFICIENT)';
+    } else {
+        if (gfi >= 70) mentalMode = '🚑 HUMBLE_RECOVERY';
+        else if (gfi >= 40) mentalMode = '🤝 CONCILIATORY';
+        else mentalMode = '⚡ EFFICIENT';
     }
+    
     // Determine health status based on GFI
     let healthLabel = 'Healthy';
     let suggestionText = '';
+
     if (isZh) {
         if (gfi > 80) {
             healthLabel = '极度疲劳 🔴';
@@ -132,14 +148,10 @@ export function handlePainCommand(ctx) {
    2. 让 AI 调用 \`deep_reflect\` 工具进行深度反思。
    3. 如果当前上下文太乱，考虑使用 \`/clear\` 开启新会话。`;
         }
-        else if (gfi > 50)
-            healthLabel = '遇到阻力 🟡';
-        else if (gfi > 20)
-            healthLabel = '轻微受挫 🟢';
-        else
-            healthLabel = '运转良好 🟢';
-    }
-    else {
+        else if (gfi > 50) healthLabel = '遇到阻力 🟡';
+        else if (gfi > 20) healthLabel = '轻微受挫 🟢';
+        else healthLabel = '运转良好 🟢';
+    } else {
         if (gfi > 80) {
             healthLabel = 'Critical 🔴';
             suggestionText = `
@@ -148,13 +160,11 @@ export function handlePainCommand(ctx) {
    2. Ask the AI to use the \`deep_reflect\` tool.
    4. Consider starting a new session with \`/clear\`.`;
         }
-        else if (gfi > 50)
-            healthLabel = 'High Friction 🟡';
-        else if (gfi > 20)
-            healthLabel = 'Minor Issues 🟢';
-        else
-            healthLabel = 'Healthy 🟢';
+        else if (gfi > 50) healthLabel = 'High Friction 🟡';
+        else if (gfi > 20) healthLabel = 'Minor Issues 🟢';
+        else healthLabel = 'Healthy 🟢';
     }
+
     // Get session empathy stats for inline display
     const sessionEmpathy = sessionId ? wctx.eventLog.getEmpathyStats('session', sessionId) : null;
     let empathyInline = '';
@@ -163,6 +173,7 @@ export function handlePainCommand(ctx) {
             ? `\n🫀 **情绪事件 (当前会话)**: ${sessionEmpathy.totalEvents} 次 (${sessionEmpathy.totalPenaltyScore}分)`
             : `\n🫀 **Empathy Events (Session)**: ${sessionEmpathy.totalEvents} (${sessionEmpathy.totalPenaltyScore}pts)`;
     }
+
     if (isZh) {
         let text = `📊 **Principles Disciple - 系统健康度监控**\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
@@ -173,15 +184,14 @@ export function handlePainCommand(ctx) {
         text += `\n\n🧠 **痛苦进化词典**: 已吸收 ${stats.totalRules} 条规则\n`;
         text += `   ↳ 累计帮您拦截了 ${stats.totalHits} 次无效操作\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+        
         if (suggestionText) {
             text += suggestionText;
-        }
-        else {
+        } else {
             text += `*💡 提示: 使用 \`/pd-status empathy\` 查看详细情绪事件统计。*`;
         }
         return { text };
-    }
-    else {
+    } else {
         let text = `📊 **Principles Disciple - System Health Monitor**\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
         text += `💊 **Current Friction (GFI)**: ${gfiBar} ${gfi}/100\n`;
@@ -191,30 +201,35 @@ export function handlePainCommand(ctx) {
         text += `\n\n🧠 **Evolution Dictionary**: ${stats.totalRules} active rules\n`;
         text += `   ↳ Successfully blocked ${stats.totalHits} invalid operations\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+        
         if (suggestionText) {
             text += suggestionText;
-        }
-        else {
+        } else {
             text += `*💡 Hint: Use \`/pd-status empathy\` to view detailed empathy event statistics.*`;
         }
         return { text };
     }
 }
+
 /**
  * Handle /pd-status empathy subcommand
  */
-function handleEmpathySubcommand(wctx, args, sessionId, isZh) {
+function handleEmpathySubcommand(
+    wctx: WorkspaceContext,
+    args: string,
+    sessionId: string | undefined,
+    isZh: boolean
+): PluginCommandResult {
     // Parse range argument
-    let range = 'today';
+    let range: 'today' | 'week' | 'session' = 'today';
     if (args.includes('--week') || args.includes('-w')) {
         range = 'week';
-    }
-    else if (args.includes('--session') || args.includes('-s')) {
+    } else if (args.includes('--session') || args.includes('-s')) {
         range = 'session';
-    }
-    else if (args.includes('--today') || args.includes('-t')) {
+    } else if (args.includes('--today') || args.includes('-t')) {
         range = 'today';
     }
+
     // Validate session range
     if (range === 'session' && !sessionId) {
         return {
@@ -223,16 +238,20 @@ function handleEmpathySubcommand(wctx, args, sessionId, isZh) {
                 : `❌ Session not found. Use this command in a chat session.`
         };
     }
+
     const stats = wctx.eventLog.getEmpathyStats(range, sessionId);
     const rangeLabel = isZh
         ? { today: '今天', week: '最近 7 天', session: '当前会话' }[range]
         : { today: 'Today', week: 'Last 7 Days', session: 'Current Session' }[range];
+
     let text = formatEmpathyCard(stats, rangeLabel, isZh);
+
     // Add usage hint
     if (range === 'today') {
         text += isZh
             ? `\n\n*💡 使用 \`/pd-status empathy --week\` 查看周统计，\`--session\` 查看会话统计。*`
             : `\n\n*💡 Use \`/pd-status empathy --week\` for weekly stats, \`--session\` for session stats.*`;
     }
+
     return { text };
 }

package/src/commands/principle-rollback.ts

@@ -0,0 +1,27 @@
+import { EvolutionReducerImpl } from '../core/evolution-reducer.js';
+import type { PluginCommandContext } from '../openclaw-sdk.js';
+
+export function handlePrincipleRollbackCommand(ctx: PluginCommandContext): { text: string } {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const argText = (ctx.args || '').trim();
+  const [principleId = '', ...reasonParts] = argText.split(/\s+/);
+  const reason = (reasonParts.join(' ') || 'manual rollback').trim();
+  const isZh = (ctx.config?.language as string)?.startsWith('zh');
+
+  if (!principleId) {
+    return { text: isZh ? '用法: /pd-principle-rollback <principleId> [reason]' : 'Usage: /pd-principle-rollback <principleId> [reason]' };
+  }
+
+  const reducer = new EvolutionReducerImpl({ workspaceDir });
+  const principle = reducer.getPrincipleById(principleId);
+  if (!principle) {
+    return { text: isZh ? `未找到原则: ${principleId}` : `Principle not found: ${principleId}` };
+  }
+
+  reducer.rollbackPrinciple(principleId, reason);
+  return {
+    text: isZh
+      ? `✅ 已回滚原则 ${principleId}\n原因: ${reason}`
+      : `✅ Rolled back principle ${principleId}\nReason: ${reason}`,
+  };
+}

package/{dist/commands/rollback.js → src/commands/rollback.ts}

@@ -1,19 +1,24 @@
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { resetFriction } from '../core/session-tracker.js';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+
 /**
  * Handles the /pd-rollback command
- *
+ * 
  * Usage:
  *   /pd-rollback <event-id>  - Rollback a specific empathy event by ID
  *   /pd-rollback last        - Rollback the last empathy event in current session
  */
-export function handleRollbackCommand(ctx) {
-    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+export function handleRollbackCommand(ctx: PluginCommandContext): PluginCommandResult {
+    const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+    
     const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-    const lang = ctx.config?.language || 'en';
+    const lang = (ctx.config?.language as string) || 'en';
     const isZh = lang === 'zh';
-    const sessionId = ctx.sessionId;
+    const sessionId = (ctx as any).sessionId;
+
     const args = (ctx.args || '').trim();
+
     if (!args) {
         return {
             text: isZh
@@ -29,6 +34,7 @@ Usage:
   /pd-rollback last        - Rollback the last event in current session`
         };
     }
+
     if (!sessionId) {
         return {
             text: isZh
@@ -36,8 +42,10 @@ Usage:
                 : `❌ Session ID not found. Use this command in a chat session.`
         };
     }
-    let eventId = null;
-    let triggerMethod = 'user_command';
+
+    let eventId: string | null = null;
+    let triggerMethod: 'user_command' = 'user_command';
+
     if (args === 'last') {
         // Find the last empathy event in current session
         eventId = wctx.eventLog.getLastEmpathyEventId(sessionId);
@@ -48,13 +56,19 @@ Usage:
                     : `❌ No empathy events found in current session to rollback.`
             };
         }
-    }
-    else {
+    } else {
         // Use the provided event ID
         eventId = args;
     }
+
     // Perform rollback
-    const rolledBackScore = wctx.eventLog.rollbackEmpathyEvent(eventId, sessionId, isZh ? '用户手动回滚' : 'User manual rollback', 'user_command');
+    const rolledBackScore = wctx.eventLog.rollbackEmpathyEvent(
+        eventId,
+        sessionId,
+        isZh ? '用户手动回滚' : 'User manual rollback',
+        'user_command'
+    );
+
     if (rolledBackScore === 0) {
         return {
             text: isZh
@@ -62,11 +76,13 @@ Usage:
                 : `❌ Failed to rollback event "${eventId}". Event may not exist or was deduped.`
         };
     }
+
     // Reduce the GFI by the rolled back score
     resetFriction(sessionId, workspaceDir, {
         source: 'user_empathy',
         amount: rolledBackScore,
     });
+
     return {
         text: isZh
             ? `✅ 已回滚情绪事件
@@ -81,12 +97,18 @@ Usage:
 💡 Hint: Session friction has been reset.`
     };
 }
+
 /**
  * Handle natural language rollback request
  * Called from prompt hook when user says things like "撤销刚才的惩罚"
  */
-export function handleNaturalLanguageRollback(wctx, sessionId, reason) {
+export function handleNaturalLanguageRollback(
+    wctx: WorkspaceContext,
+    sessionId: string | undefined,
+    reason: string
+): { success: boolean; score: number; message: string } {
     const isZh = wctx.config.get('language') === 'zh';
+
     if (!sessionId) {
         return {
             success: false,
@@ -94,6 +116,7 @@ export function handleNaturalLanguageRollback(wctx, sessionId, reason) {
             message: isZh ? '无法识别当前会话' : 'Session not found'
         };
     }
+
     const eventId = wctx.eventLog.getLastEmpathyEventId(sessionId);
     if (!eventId) {
         return {
@@ -102,7 +125,14 @@ export function handleNaturalLanguageRollback(wctx, sessionId, reason) {
             message: isZh ? '当前会话没有可回滚的情绪事件' : 'No empathy events to rollback'
         };
     }
-    const rolledBackScore = wctx.eventLog.rollbackEmpathyEvent(eventId, sessionId, reason, 'natural_language');
+
+    const rolledBackScore = wctx.eventLog.rollbackEmpathyEvent(
+        eventId,
+        sessionId,
+        reason,
+        'natural_language'
+    );
+
     if (rolledBackScore === 0) {
         return {
             success: false,
@@ -110,11 +140,13 @@ export function handleNaturalLanguageRollback(wctx, sessionId, reason) {
             message: isZh ? '回滚失败，事件可能不存在' : 'Rollback failed, event may not exist'
         };
     }
+
     // 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/src/commands/samples.ts

@@ -0,0 +1,60 @@
+import { WorkspaceContext } from '../core/workspace-context.js';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+
+function isZh(ctx: PluginCommandContext): boolean {
+  return String(ctx.config?.language || 'en').startsWith('zh');
+}
+
+export function handleSamplesCommand(ctx: PluginCommandContext): PluginCommandResult {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const zh = isZh(ctx);
+  const args = (ctx.args || '').trim();
+  const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+
+  if (args.startsWith('review ')) {
+    const [, decision = '', sampleId = '', ...noteParts] = args.split(/\s+/);
+    if (decision !== 'approve' && decision !== 'reject') {
+      return {
+        text: zh
+          ? '无效的审核动作。请使用 `review approve <sample-id> [note]` 或 `review reject <sample-id> [note]`。'
+          : 'Invalid review action. Use `review approve <sample-id> [note]` or `review reject <sample-id> [note]`.',
+      };
+    }
+    if (!sampleId) {
+      return {
+        text: zh
+          ? '缺少 sample-id。'
+          : 'Missing sample-id.',
+      };
+    }
+    const normalizedDecision = decision === 'approve' ? 'approved' : 'rejected';
+    const note = noteParts.join(' ').trim();
+    let record;
+    try {
+      record = wctx.trajectory.reviewCorrectionSample(sampleId, normalizedDecision, note);
+    } catch (error) {
+      return {
+        text: zh
+          ? `审核样本失败：${sampleId}`
+          : `Failed to review sample: ${sampleId}`,
+      };
+    }
+    return {
+      text: zh
+        ? `样本 ${record.sampleId} 已标记为 ${record.reviewStatus}。`
+        : `Sample ${record.sampleId} marked as ${record.reviewStatus}.`,
+    };
+  }
+
+  const samples = wctx.trajectory.listCorrectionSamples('pending');
+  if (samples.length === 0) {
+    return { text: zh ? '当前没有待审核纠错样本。' : 'No pending correction samples.' };
+  }
+
+  const lines = samples.map((sample) => `- ${sample.sampleId} | session=${sample.sessionId} | score=${sample.qualityScore}`);
+  return {
+    text: zh
+      ? `待审核纠错样本:\n${lines.join('\n')}`
+      : `Pending correction samples:\n${lines.join('\n')}`,
+  };
+}

package/src/commands/strategy.ts

@@ -0,0 +1,38 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { WorkspaceContext } from '../core/workspace-context.js';
+
+export function handleInitStrategy(ctx: PluginCommandContext): PluginCommandResult {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+
+  const okrDir = wctx.resolve('OKR_DIR').replace(workspaceDir, '').replace(/^\/+/, '');
+  const focusPath = wctx.resolve('CURRENT_FOCUS').replace(workspaceDir, '').replace(/^\/+/, '');
+  const userContextPath = wctx.resolve('USER_CONTEXT').replace(workspaceDir, '').replace(/^\/+/, '');
+
+  return {
+    text:
+      `🎯 **Strategy Initialization**\n\n` +
+      `The Agent will now conduct a deep interview to establish your project's vision and strategic OKRs.\n\n` +
+      `**Instructions for Agent:** Read \`${okrDir}/\` for existing context. ` +
+      `Generate \`${focusPath}\` with the top 1-3 strategic focus areas based on the user interview. ` +
+      `Then update \`${userContextPath}\` with key user preferences discovered.`,
+  };
+}
+
+export function handleManageOkr(ctx: PluginCommandContext): PluginCommandResult {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+
+  const focusPath = wctx.resolve('CURRENT_FOCUS').replace(workspaceDir, '').replace(/^\/+/, '');
+  const weekStatePath = wctx.resolve('WEEK_STATE').replace(workspaceDir, '').replace(/^\/+/, '');
+
+  return {
+    text:
+      `📊 **OKR Management**\n\n` +
+      `The Agent will analyze recent work and align sub-agent objectives.\n\n` +
+      `**Instructions for Agent:** Read \`${focusPath}\` and \`${weekStatePath}\`. ` +
+      `Compare them against recent session history. ` +
+      `Update OKRs as needed and output a brief alignment report. ` +
+      `If OKRs are stale (>7 days), prompt the user for a re-alignment conversation.`,
+  };
+}