principles-disciple 1.5.4 → 1.6.0

package/dist/types/event-types.d.ts

@@ -1,8 +1,8 @@
 /**
  * Event types for structured logging and daily statistics.
  */
-export type EventType = 'tool_call' | 'pain_signal' | 'rule_match' | 'rule_promotion' | 'hook_execution' | 'gate_block' | 'plan_approval' | 'evolution_task' | 'deep_reflection' | 'trust_change' | 'error' | 'warn';
-export type EventCategory = 'success' | 'failure' | 'detected' | 'blocked' | 'approved' | 'enqueued' | 'completed' | 'promoted' | 'passed' | 'changed';
+export type EventType = 'tool_call' | 'pain_signal' | 'rule_match' | 'rule_promotion' | 'hook_execution' | 'gate_block' | 'plan_approval' | 'evolution_task' | 'deep_reflection' | 'trust_change' | 'empathy_rollback' | 'error' | 'warn';
+export type EventCategory = 'success' | 'failure' | 'detected' | 'blocked' | 'approved' | 'enqueued' | 'completed' | 'promoted' | 'passed' | 'changed' | 'rolled_back';
 /**
  * Base event structure for JSONL logging.
  */
@@ -42,6 +42,14 @@ export interface PainSignalEventData {
     source: string;
     reason?: string;
     isRisky?: boolean;
+    origin?: 'assistant_self_report' | 'user_manual' | 'system_infer';
+    severity?: 'mild' | 'moderate' | 'severe';
+    confidence?: number;
+    detection_mode?: 'structured' | 'legacy_tag';
+    deduped?: boolean;
+    trigger_text_excerpt?: string;
+    raw_score?: number;
+    calibrated_score?: number;
 }
 export interface RuleMatchEventData {
     ruleId: string;
@@ -106,6 +114,18 @@ export interface DeepReflectionEventData {
     /** 发现的风险数量 */
     risksCount?: number;
 }
+export interface EmpathyRollbackEventData {
+    /** Event ID being rolled back */
+    eventId: string;
+    /** Original penalty score that was applied */
+    originalScore: number;
+    /** Session ID where the original event occurred */
+    originalSessionId?: string;
+    /** Reason for rollback (manual, false_positive, etc.) */
+    reason: string;
+    /** Who initiated the rollback */
+    triggeredBy: 'user_command' | 'natural_language' | 'system';
+}
 export interface ToolCallStats {
     total: number;
     success: number;
@@ -128,6 +148,59 @@ export interface PainStats {
     avgScore: number;
     maxScore: number;
 }
+/**
+ * Empathy Engine event statistics for tracking emotional signals.
+ * Used for /pd-status empathy card and effectiveness metrics.
+ */
+export interface EmpathyEventStats {
+    /** Total empathy events detected (excluding deduped) */
+    totalEvents: number;
+    /** Events that were deduped (not counted in totalEvents) */
+    dedupedCount: number;
+    /** Dedupe hit rate (dedupedCount / (totalEvents + dedupedCount)) */
+    dedupeHitRate: number;
+    /** Total penalty score applied */
+    totalPenaltyScore: number;
+    /** Score rolled back via manual rollback */
+    rolledBackScore: number;
+    /** Number of rollback operations */
+    rollbackCount: number;
+    /** Events by severity level */
+    bySeverity: {
+        mild: number;
+        moderate: number;
+        severe: number;
+    };
+    /** Score by severity level */
+    scoreBySeverity: {
+        mild: number;
+        moderate: number;
+        severe: number;
+    };
+    /** Events by detection mode */
+    byDetectionMode: {
+        structured: number;
+        legacy_tag: number;
+    };
+    /** Events by origin */
+    byOrigin: {
+        assistant_self_report: number;
+        user_manual: number;
+        system_infer: number;
+    };
+    /** Confidence distribution */
+    confidenceDistribution: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+    /** Daily trend (last 7 days) */
+    dailyTrend: Array<{
+        date: string;
+        count: number;
+        score: number;
+    }>;
+}
 export interface GfiStats {
     peak: number;
     samples: number;
@@ -214,6 +287,8 @@ export interface DailyStats {
     errors: ErrorStats;
     /** Pain signal statistics */
     pain: PainStats;
+    /** Empathy Engine event statistics */
+    empathy: EmpathyEventStats;
     /** GFI statistics */
     gfi: GfiStats;
     /** Evolution statistics */

package/dist/types/event-types.js

@@ -34,6 +34,39 @@ export function createEmptyDailyStats(date) {
             avgScore: 0,
             maxScore: 0,
         },
+        empathy: {
+            totalEvents: 0,
+            dedupedCount: 0,
+            dedupeHitRate: 0,
+            totalPenaltyScore: 0,
+            rolledBackScore: 0,
+            rollbackCount: 0,
+            bySeverity: {
+                mild: 0,
+                moderate: 0,
+                severe: 0,
+            },
+            scoreBySeverity: {
+                mild: 0,
+                moderate: 0,
+                severe: 0,
+            },
+            byDetectionMode: {
+                structured: 0,
+                legacy_tag: 0,
+            },
+            byOrigin: {
+                assistant_self_report: 0,
+                user_manual: 0,
+                system_infer: 0,
+            },
+            confidenceDistribution: {
+                high: 0,
+                medium: 0,
+                low: 0,
+            },
+            dailyTrend: [],
+        },
         gfi: {
             peak: 0,
             samples: 0,

package/dist/types.d.ts

@@ -1 +1,43 @@
 export type { PluginCommandContext, PluginCommandResult } from './openclaw-sdk.js';
+/**
+ * Context Injection Configuration
+ * Controls what content gets injected into the LLM prompt.
+ *
+ * NOTE: Core Principles (PRINCIPLES.md) are ALWAYS injected and cannot be disabled.
+ * This is by design - principles are the foundation of the agent's behavior.
+ */
+export type ProjectFocusMode = 'full' | 'summary' | 'off';
+export interface ContextInjectionConfig {
+    /** Thinking OS (mental models) - can be toggled */
+    thinkingOs: boolean;
+    /** Project context (CURRENT_FOCUS.md) mode */
+    projectFocus: ProjectFocusMode;
+    /** Reflection log - can be toggled */
+    reflectionLog: boolean;
+    /** Trust score awareness - can be toggled */
+    trustScore: boolean;
+}
+/**
+ * Default context injection configuration
+ * Based on user requirements:
+ * - principles: always on (not configurable)
+ * - thinkingOs: true (can be turned off)
+ * - projectFocus: 'off' (default closed, user can enable)
+ * - reflectionLog: true (default on)
+ * - trustScore: true (can be turned off)
+ */
+export declare const defaultContextConfig: ContextInjectionConfig;
+/**
+ * Reflection log entry structure
+ */
+export interface ReflectionLogEntry {
+    timestamp: string;
+    context: string;
+    insights: string;
+    modelId?: string;
+    depth?: number;
+}
+/**
+ * Reflection log retention configuration
+ */
+export declare const reflectionLogRetentionDays = 7;

package/dist/types.js

@@ -1 +1,19 @@
-export {};
+/**
+ * Default context injection configuration
+ * Based on user requirements:
+ * - principles: always on (not configurable)
+ * - thinkingOs: true (can be turned off)
+ * - projectFocus: 'off' (default closed, user can enable)
+ * - reflectionLog: true (default on)
+ * - trustScore: true (can be turned off)
+ */
+export const defaultContextConfig = {
+    thinkingOs: true,
+    projectFocus: 'off',
+    reflectionLog: true,
+    trustScore: true,
+};
+/**
+ * Reflection log retention configuration
+ */
+export const reflectionLogRetentionDays = 7;

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.5.4",
+  "version": "1.6.0",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,7 +40,7 @@
   },
   "devDependencies": {
     "@types/micromatch": "^4.0.10",
-    "@types/node": "^20.0.0",
+    "@types/node": "^25.5.0",
     "@types/ws": "^8.5.13",
     "@vitest/coverage-v8": "^4.1.0",
     "esbuild": "^0.27.4",
@@ -60,4 +60,4 @@
     "@sinclair/typebox": "^0.34.48",
     "micromatch": "^4.0.8"
   }
-}
+}

package/templates/langs/zh/core/HEARTBEAT.md

@@ -18,10 +18,34 @@
 
 ## 📋 CURRENT_FOCUS.md 维护（每3次心跳）
 
-- [ ] **检查文件大小**：目标 < 50 行
-- [ ] **如 > 50 行**：压缩已完成里程碑到 `MEMORY.md`
-- [ ] **验证内容**：无过期日期或已完成任务
-- [ ] **只保留**：当前阶段、进行中任务、下一步
+### 检查与压缩
+
+- [ ] **检查文件大小**：目标 < 40 行
+- [ ] **如 > 40 行**：执行压缩流程（见下方）
+
+### 压缩流程
+
+1. **备份当前版本**：复制到 `memory/okr/.history/CURRENT_FOCUS.v{N}.{date}.md`
+2. **递增版本号**：修改 `**版本**: v{N+1}`
+3. **更新日期**：修改 `**更新**: {today}`
+4. **压缩内容**：
+   - 移除已完成的 P0/P1 任务（保留 P2）
+   - 将重要里程碑移到 `MEMORY.md`
+   - 保留：状态快照、当前任务、下一步
+5. **清理历史**：保留最近 10 个历史版本
+
+### 模板结构（编辑时遵循）
+
+```markdown
+# 🎯 CURRENT_FOCUS
+
+> **版本**: v{N} | **状态**: {状态} | **更新**: {日期}
+
+## 📍 状态快照    ← 必须保留
+## 🔄 当前任务    ← 必须保留
+## ➡️ 下一步      ← 必须保留（summary 模式优先提取）
+## 📎 参考        ← 可选
+```
 
 ---
 

package/templates/pain_settings.json

@@ -68,10 +68,62 @@
     "auto_trigger_conditions": {
       "min_tool_calls": 5,
       "error_rate_threshold": 0.3,
-      "complexity_keywords": ["refactor", "architecture", "design", "optimize", "security", "critical"]
+      "complexity_keywords": [
+        "refactor",
+        "architecture",
+        "design",
+        "optimize",
+        "security",
+        "critical"
+      ]
     },
     "default_model": "T-01",
     "default_depth": 2,
     "timeout_ms": 60000
+  },
+  "empathy_engine": {
+    "enabled": true,
+    "dedupe_window_ms": 60000,
+    "penalties": {
+      "mild": 10,
+      "moderate": 25,
+      "severe": 40
+    },
+    "rate_limit": {
+      "max_per_turn": 40,
+      "max_per_hour": 120
+    },
+    "model_calibration": {}
+  },
+  "gfi_gate": {
+    "enabled": true,
+    "thresholds": {
+      "low_risk_block": 70,
+      "high_risk_block": 40,
+      "large_change_block": 50
+    },
+    "large_change_lines": 50,
+    "trust_stage_multipliers": {
+      "1": 0.5,
+      "2": 0.75,
+      "3": 1.0,
+      "4": 1.5
+    },
+    "bash_safe_patterns": [
+      "^(ls|dir|pwd|which|where|echo|env|cat|type|head|tail|less|more)\\b",
+      "^git\\s+(status|log|diff|branch|show|remote)\\b",
+      "^npm\\s+(run|test|build|start)\\b",
+      "^(make|gradle|mvn)\\b"
+    ],
+    "bash_dangerous_patterns": [
+      "rm\\s+(-[a-z]*r[a-z]*f|-rf)",
+      "del\\s+/s",
+      "rmdir\\s+/s",
+      "git\\s+(push\\s+.*--force|reset\\s+--hard|clean\\s+-fd)",
+      "npm\\s+publish",
+      "pip\\s+upload",
+      "docker\\s+push",
+      "(curl|wget).*\\|\\s*(ba)?sh"
+    ]
   }
-}
+}

package/templates/workspace/.principles/PROFILE.json

@@ -6,6 +6,7 @@
     "IDENTITY.md",
     "USER.md",
     "docs/PRINCIPLES.md",
+    ".principles/PROFILE.json",
     "docs/PROFILE.json"
   ],
   "gate": {
@@ -22,6 +23,7 @@
         "IDENTITY.md",
         "USER.md",
         "docs/PRINCIPLES.md",
+        ".principles/PROFILE.json",
         "docs/PROFILE.json",
         "docs/okr/**"
       ],

package/templates/workspace/okr/CURRENT_FOCUS.md

@@ -0,0 +1,57 @@
+# 🎯 CURRENT_FOCUS
+
+> **版本**: v1 | **状态**: INIT | **更新**: {YYYY-MM-DD}
+
+---
+
+## 📍 状态快照
+
+| 维度 | 值 |
+|------|-----|
+| 当前阶段 | 初始化 |
+| 信任分数 | 85/100 |
+| 认知卫生 | ✅ 清爽 |
+
+---
+
+## 🔄 当前任务
+
+### P0（阻塞/紧急）
+<!-- 阻塞项，需要立即处理 -->
+- [ ] 无
+
+### P1（进行中）
+<!-- 当前正在进行的核心任务，最多 3 项 -->
+- [ ] {任务描述} ← 当前
+
+### P2（待办）
+<!-- 优先级较低的待办事项 -->
+- [ ] {任务描述}
+
+---
+
+## ➡️ 下一步
+
+<!-- 下一步行动，按优先级排序 -->
+1. {下一步行动1}
+2. {下一步行动2}
+
+---
+
+## 📎 参考
+
+| 资源 | 路径 |
+|------|------|
+| 详细计划 | `memory/tasks/{任务目录}/PLAN.md` |
+| 历史版本 | `memory/okr/.history/` |
+| 任务列表 | `memory/okr/WEEK_TASKS.json` |
+
+---
+
+<!--
+编辑指南：
+1. 版本号每次压缩时 +1
+2. 状态可选：INIT | PLANNING | EXECUTING | BLOCKED | DONE
+3. 压缩时备份到 .history/CURRENT_FOCUS.v{N}.{date}.md
+4. 目标：< 40 行，超过时压缩已完成任务到 MEMORY.md
+-->