principles-disciple 1.153.0 → 1.154.0

package/dist/hooks/prompt-helpers.d.ts

@@ -89,3 +89,17 @@ export declare function formatEvolutionPrinciples(active: EvolutionPrincipleEntr
  * @returns Assembled appendSystemContext (empty string if no parts)
  */
 export declare function assembleAppendSystemContext(parts: AppendSystemContextParts): string;
+/**
+ * Extracts short, distinct keyword phrases from an EmpathyObserver reason string.
+ *
+ * Used to feed newly detected expressions back into the keyword store, so the
+ * keyword-based fast path can catch them on future turns without re-running
+ * the more expensive observer.
+ *
+ * Pure function — no I/O, no side effects. Fully unit-testable.
+ *
+ * @param reason - observer's reason string (e.g., "用户表达了强烈的挫败感，提到反复尝试失败")
+ * @param lang - UI locale for minimum length threshold (zh=2 chars, en=3 chars)
+ * @returns deduplicated array of up to 3 candidate phrases
+ */
+export declare function extractPhrasesFromReason(reason: string, lang: 'zh' | 'en'): string[];

package/dist/hooks/prompt-helpers.js

@@ -260,3 +260,29 @@ ${executionRules.join('\n')}
 `;
     return result;
 }
+// ---------------------------------------------------------------------------
+// Block H: Observer feedback → keyword phrase extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extracts short, distinct keyword phrases from an EmpathyObserver reason string.
+ *
+ * Used to feed newly detected expressions back into the keyword store, so the
+ * keyword-based fast path can catch them on future turns without re-running
+ * the more expensive observer.
+ *
+ * Pure function — no I/O, no side effects. Fully unit-testable.
+ *
+ * @param reason - observer's reason string (e.g., "用户表达了强烈的挫败感，提到反复尝试失败")
+ * @param lang - UI locale for minimum length threshold (zh=2 chars, en=3 chars)
+ * @returns deduplicated array of up to 3 candidate phrases
+ */
+export function extractPhrasesFromReason(reason, lang) {
+    const MAX_PHRASES = 3;
+    const MIN_LENGTH = lang === 'zh' ? 2 : 3;
+    const MAX_LENGTH = 20;
+    const segments = reason
+        .split(/[,，。.！!？?、\n；;]/)
+        .map(s => s.trim())
+        .filter(s => s.length >= MIN_LENGTH && s.length <= MAX_LENGTH);
+    return [...new Set(segments)].slice(0, MAX_PHRASES);
+}

package/dist/hooks/prompt.js

@@ -11,7 +11,7 @@ import { selectPrinciplesForInjection, DEFAULT_PRINCIPLE_BUDGET } from '../core/
 import { getCachedMaskedPrincipleSet, WorkflowFunnelLoader, PiAiRuntimeAdapter, EmpathyObserver, AgentScheduler, RUNTIME_V2_PRINCIPLE_BUDGET, trimToBudget, renderPrinciplesToDirectives } from '@principles/core/runtime-v2';
 import { truncateInjectionToBudget } from '@principles/core/prompt-builder';
 import { PromptActivationReader } from '../core/runtime-v2-prompt-activation-reader.js';
-import { matchEmpathyKeywords, loadKeywordStore, saveKeywordStore, getKeywordStoreSummary, } from '../core/empathy-keyword-matcher.js';
+import { matchEmpathyKeywords, loadKeywordStore, saveKeywordStore, applyKeywordUpdates, getKeywordStoreSummary, } from '../core/empathy-keyword-matcher.js';
 import { severityToPenalty, DEFAULT_EMPATHY_KEYWORD_CONFIG } from '../core/empathy-types.js';
 import { evaluatePainDiagnosticGate } from '../core/pain-diagnostic-gate.js';
 import { emitPainDetectedEvent, buildTrajectoryEvidence } from './pain.js';
@@ -25,7 +25,7 @@ import { buildIntentFrictionBlock } from '@principles/core/runtime-v2';
 import { CorrectionCueLearner } from '../core/correction-cue-learner.js';
 import { detectCorrectionCue as coreDetectCorrectionCue, escapeXml, extractMessageContent, isMinimalTrigger, } from '@principles/core/prompt-builder';
 import { sanitizeForEvidence } from './message-sanitize.js';
-import { buildAgentIdentity, buildEmpathySilenceConstraint, extractUserMessageFromPrompt, assembleHeartbeatChecklist, formatCorePrinciples, formatEvolutionPrinciples, assembleAppendSystemContext, } from './prompt-helpers.js';
+import { buildAgentIdentity, buildEmpathySilenceConstraint, extractUserMessageFromPrompt, assembleHeartbeatChecklist, formatCorePrinciples, formatEvolutionPrinciples, assembleAppendSystemContext, extractPhrasesFromReason, } from './prompt-helpers.js';
 // ---------------------------------------------------------------------------
 // Static file cache — avoids re-reading rarely-changing files every message
 // ---------------------------------------------------------------------------
@@ -305,6 +305,8 @@ export async function handleBeforePromptBuild(event, ctx) {
                 // Increment turn counter (Finding #3: session.turnCount doesn't exist)
                 empathyState.turnCounter++;
                 const turnCount = empathyState.turnCounter;
+                const painTrigger = wctx.config.get('thresholds.pain_trigger') || 40;
+                const highGfiThreshold = Math.max(wctx.config.get('severity_thresholds.high') || 70, painTrigger + 30);
                 if (matchResult.matched) {
                     const penalty = severityToPenalty(matchResult.severity, DEFAULT_EMPATHY_KEYWORD_CONFIG);
                     // trackFriction signature: (sessionId, deltaF: number, hash: string, workspaceDir?, options?)
@@ -314,8 +316,6 @@ export async function handleBeforePromptBuild(event, ctx) {
                     logger?.info?.(`[PD:Empathy] MATCH: "${matchResult.matchedTerms.join(', ')}" → severity=${matchResult.severity}, score=${matchResult.score.toFixed(2)}, penalty=${penalty}`);
                     const currentSession = getSession(sessionId);
                     const currentGfi = currentSession?.currentGfi ?? 0;
-                    const painTrigger = wctx.config.get('thresholds.pain_trigger') || 40;
-                    const highGfiThreshold = Math.max(wctx.config.get('severity_thresholds.high') || 70, painTrigger + 30);
                     if (currentGfi >= highGfiThreshold) {
                         const gfiPainScore = Math.min(Math.round(currentGfi), 60);
                         logger?.info?.(`[PD:Empathy] GFI-TRIGGERED: currentGfi=${currentGfi.toFixed(1)} >= highGfi=${highGfiThreshold}, emitting pain signal (score=${gfiPainScore})`);
@@ -451,7 +451,9 @@ export async function handleBeforePromptBuild(event, ctx) {
                             }
                         }
                     }
-                    // Trigger asynchronous background Empathy Observer deep analysis (Zero Latency)
+                }
+                else {
+                    // ── Pipeline: Observer only runs when keyword matcher misses ──
                     const observer = resolveEmpathyObserver(wctx, logger);
                     if (observer) {
                         const scheduler = new AgentScheduler();
@@ -460,14 +462,40 @@ export async function handleBeforePromptBuild(event, ctx) {
                             mode: 'realtime',
                             runner: observer,
                         });
-                        logger?.info?.(`[PD:Empathy] Triggering background Empathy Observer deep analysis for message: "${msgPreview}"`);
+                        logger?.info?.(`[PD:Empathy] Pipeline: Triggering background Empathy Observer for unmatched message: "${msgPreview}"`);
                         void scheduler.dispatch('empathy-observer', { userMessage: latestUserMessage })
                             .then(async (result) => {
                             if (result.damageDetected) {
-                                logger?.info?.(`[PD:Empathy] Background Empathy Observer detected damage. Severity: ${result.severity}, Reason: ${result.reason}`);
+                                logger?.info?.(`[PD:Empathy] Pipeline: Background Empathy Observer detected damage. Severity: ${result.severity}, Reason: ${result.reason}`);
                                 // ── Persistence Contract ──
                                 const painScore = scoreFromSeverityForSpec(result.severity, wctx);
                                 trackFriction(sessionId, painScore, `observer_empathy_${result.severity}`, workspaceDir, { source: 'user_empathy' });
+                                // ── Pipeline: feed back newly detected expressions into keyword store ──
+                                if (result.reason) {
+                                    const rawLang = wctx.config.get('language');
+                                    const lang = rawLang === 'en' ? 'en' : 'zh';
+                                    const phrases = extractPhrasesFromReason(result.reason, lang);
+                                    if (phrases.length > 0) {
+                                        const updates = {};
+                                        for (const phrase of phrases) {
+                                            if (!Object.hasOwn(keywordStore.terms, phrase)) {
+                                                updates[phrase] = {
+                                                    action: 'add',
+                                                    weight: 0.4,
+                                                    falsePositiveRate: 0.3,
+                                                    reasoning: `Discovered by empathy observer: ${result.reason.substring(0, 100)}`,
+                                                };
+                                            }
+                                        }
+                                        if (Object.keys(updates).length > 0) {
+                                            const { added } = applyKeywordUpdates(keywordStore, updates);
+                                            if (added > 0) {
+                                                saveKeywordStore(wctx.stateDir, keywordStore);
+                                                logger?.info?.(`[PD:Empathy] Pipeline: added ${added} new terms from observer feedback`);
+                                            }
+                                        }
+                                    }
+                                }
                                 const eventId = `emp_obs_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
                                 wctx.eventLog.recordPainSignal(sessionId, {
                                     score: painScore,
@@ -524,7 +552,7 @@ export async function handleBeforePromptBuild(event, ctx) {
                                         const sourceKind = resolveSourceKind(rawObs);
                                         const triage = evaluateEvidenceTriage(sourceKind, freshGfiPainScore);
                                         if (triage.decision !== 'admit') {
-                                            logger?.info?.(`[PD:Empathy] Observer triage ${triage.decision}: ${triage.reason}`);
+                                            logger?.info?.(`[PD:Empathy] Pipeline observer triage ${triage.decision}: ${triage.reason}`);
                                         }
                                         else {
                                             const cooldownActive = isSharedCooldownActive(sourceKind, sessionId, 'empathy_gfi_observer');
@@ -538,7 +566,7 @@ export async function handleBeforePromptBuild(event, ctx) {
                                             });
                                             if (triggerDecision.shouldCreateDiagnosticTask) {
                                                 markSharedEpisodeAsDiagnosed(sourceKind, sessionId, 'empathy_gfi_observer');
-                                                logger?.info?.(`[PD:Empathy] Gate B approved (observer), calling emitPainDetectedEvent...`);
+                                                logger?.info?.(`[PD:Empathy] Pipeline Gate B approved (observer), calling emitPainDetectedEvent...`);
                                                 try {
                                                     const evidence = buildTrajectoryEvidence(wctx, sessionId);
                                                     // PRI-453: Reuse observerPainId for lineage consistency —
@@ -562,11 +590,11 @@ export async function handleBeforePromptBuild(event, ctx) {
                                                     }, { recordObservability: false });
                                                 }
                                                 catch (emitErr) {
-                                                    logger?.error?.(`[PD:Empathy] FAILED to emit observer-triggered pain event: ${String(emitErr)}`);
+                                                    logger?.error?.(`[PD:Empathy] Pipeline FAILED to emit observer-triggered pain event: ${String(emitErr)}`);
                                                 }
                                             }
                                             else {
-                                                logger?.info?.(`[PD:Empathy] Gate B skipped (observer): ${triggerDecision.reason}`);
+                                                logger?.info?.(`[PD:Empathy] Pipeline Gate B skipped (observer): ${triggerDecision.reason}`);
                                             }
                                         }
                                     }
@@ -586,7 +614,7 @@ export async function handleBeforePromptBuild(event, ctx) {
                                             },
                                         });
                                         if (gate.shouldDiagnose) {
-                                            logger?.info?.(`[PD:Empathy] GFI threshold crossed after background observer. Emitting pain signal...`);
+                                            logger?.info?.(`[PD:Empathy] Pipeline GFI threshold crossed after background observer. Emitting pain signal...`);
                                             try {
                                                 const evidence = buildTrajectoryEvidence(wctx, sessionId);
                                                 // PRI-453: Reuse observerPainId for lineage consistency —
@@ -610,22 +638,20 @@ export async function handleBeforePromptBuild(event, ctx) {
                                                 }, { recordObservability: false });
                                             }
                                             catch (emitErr) {
-                                                logger?.error?.(`[PD:Empathy] FAILED to emit observer-triggered pain event: ${String(emitErr)}`);
+                                                logger?.error?.(`[PD:Empathy] Pipeline FAILED to emit observer-triggered pain event: ${String(emitErr)}`);
                                             }
                                         }
                                     }
                                 }
                             }
                             else {
-                                logger?.info?.(`[PD:Empathy] Background Empathy Observer did not detect any damage.`);
+                                logger?.info?.(`[PD:Empathy] Pipeline: Background Empathy Observer did not detect any damage.`);
                             }
                         })
                             .catch((err) => {
-                            logger?.warn?.(`[PD:Empathy] Background analysis failed or rejected: ${String(err)}`);
+                            logger?.warn?.(`[PD:Empathy] Pipeline: Background analysis failed or rejected: ${String(err)}`);
                         });
                     }
-                }
-                else {
                     // Log unmatched messages periodically for coverage analysis
                     if (turnCount > 0 && turnCount % 50 === 0) {
                         const sampleMsg = latestUserMessage.substring(0, 80).replace(/\n/g, ' ');

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.153.0",
+  "version": "1.154.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.153.0",
+  "version": "1.154.0",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
   "main": "./dist/bundle.js",