openclaw-topic-shift-reset 0.4.1 → 0.4.3

package/README.md

@@ -154,8 +154,8 @@ All plugin logs are prefixed with `topic-shift-reset:`.
 
 ### Debug (`debug: true`)
 
-- `classify source=<...> kind=<warmup|stable|suspect|rotate-hard|rotate-soft> reason=<...> ...`
-  Full classifier output and metrics for a processed message.
+- `classify source=<...> kind=<warmup|stable|suspect|rotate-hard|rotate-soft> reason=<...> ... textHash=<...> tokens=[...] text="..."`
+  Full classifier output and metrics plus a compact message preview for a processed message.
 - `suspect-queued session=<...>`
   Soft-suspect state queued for clarification steering.
 - `ask-injected session=<...>`

package/docs/configuration.md

@@ -47,7 +47,7 @@ With `softSuspect.mode: "strict"` (default), a soft-confirm reset is blocked unt
 - `softSuspect.prompt`: optional steer text injected on soft-suspect.
 - `softSuspect.ttlSeconds`: expiry for pending soft-suspect steer.
 - `dryRun`: logs would-rotate events without session resets.
-- `debug`: emits per-message classifier diagnostics.
+- `debug`: emits per-message classifier diagnostics, including compact message previews.
 
 ## Built-in preset defaults
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-topic-shift-reset",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "OpenClaw plugin that detects topic shifts and starts a fresh session automatically.",
   "type": "module",
   "main": "./src/index.ts",

package/src/index.ts

@@ -329,6 +329,8 @@ const STALE_SESSION_STATE_MS = 4 * 60 * 60 * 1000;
 const MAX_RECENT_MESSAGE_EVENTS = 20_000;
 const MESSAGE_EVENT_TTL_MS = 5 * 60 * 1000;
 const ROTATION_DEDUPE_MS = 25_000;
+const DEBUG_LOG_TEXT_PREVIEW_CHARS = 180;
+const DEBUG_LOG_TOKEN_PREVIEW_COUNT = 12;
 const PERSISTENCE_SCHEMA_VERSION = 1;
 const PERSISTENCE_FILE_NAME = "runtime-state.v1.json";
 const PERSISTENCE_FLUSH_DEBOUNCE_MS = 1_200;
@@ -1250,8 +1252,9 @@ function classifyMessage(params: {
   now: number;
 }): ClassificationDecision {
   const { cfg, state, now } = params;
+  const hasSimilarity = params.usedEmbedding && typeof params.similarity === "number";
   const score =
-    params.usedEmbedding && typeof params.similarity === "number"
+    hasSimilarity
       ? 0.7 * (1 - params.similarity) +
         0.15 * params.lexical.lexicalDistance +
         0.15 * params.lexical.novelty
@@ -1279,21 +1282,25 @@ function classifyMessage(params: {
     return { kind: "stable", metrics, reason: "cooldown" };
   }
 
+  const lexicalHardSignal =
+    params.lexical.score >= cfg.hardScoreThreshold ||
+    (params.lexical.novelty >= cfg.hardNoveltyThreshold &&
+      params.lexical.lexicalDistance >= 0.65);
   const hardSignal =
-    score >= cfg.hardScoreThreshold ||
-    (params.usedEmbedding && typeof params.similarity === "number"
-      ? params.similarity <= cfg.hardSimilarityThreshold &&
-        params.lexical.novelty >= cfg.hardNoveltyThreshold
-      : params.lexical.novelty >= cfg.hardNoveltyThreshold &&
-        params.lexical.lexicalDistance >= 0.65);
+    hasSimilarity &&
+    (score >= cfg.hardScoreThreshold ||
+      (params.similarity <= cfg.hardSimilarityThreshold &&
+        params.lexical.novelty >= cfg.hardNoveltyThreshold));
 
   if (hardSignal) {
     return { kind: "rotate-hard", metrics, reason: "hard-threshold" };
   }
 
+  const forceSoftPathFromLexicalHard = !hasSimilarity && lexicalHardSignal;
   const softSignal =
+    forceSoftPathFromLexicalHard ||
     score >= cfg.softScoreThreshold ||
-    (params.usedEmbedding && typeof params.similarity === "number"
+    (hasSimilarity
       ? params.similarity <= cfg.softSimilarityThreshold &&
         params.lexical.novelty >= cfg.softNoveltyThreshold
       : params.lexical.novelty >= cfg.softNoveltyThreshold &&
@@ -2057,23 +2064,31 @@ export default function register(api: OpenClawPluginApi): void {
     }
 
     if (cfg.debug) {
-      api.logger.debug(
-        [
-          `topic-shift-reset: classify`,
-          `source=${params.source}`,
-          `kind=${decision.kind}`,
-          `reason=${decision.reason}`,
-          `session=${sessionKey}`,
-          `score=${decision.metrics.score.toFixed(3)}`,
-          `novelty=${decision.metrics.novelty.toFixed(3)}`,
-          `lex=${decision.metrics.lexicalDistance.toFixed(3)}`,
-          `uniq=${decision.metrics.uniqueTokenRatio.toFixed(3)}`,
-          `entropy=${decision.metrics.entropy.toFixed(3)}`,
-          `sim=${typeof decision.metrics.similarity === "number" ? decision.metrics.similarity.toFixed(3) : "n/a"}`,
-          `embed=${decision.metrics.usedEmbedding ? "1" : "0"}`,
-          `pending=${state.pendingSoftSignals}`,
-        ].join(" "),
-      );
+      const textPreview = truncateText(text, DEBUG_LOG_TEXT_PREVIEW_CHARS);
+      const rawPreview = truncateText(rawText, DEBUG_LOG_TEXT_PREVIEW_CHARS);
+      const debugFields = [
+        `topic-shift-reset: classify`,
+        `source=${params.source}`,
+        `kind=${decision.kind}`,
+        `reason=${decision.reason}`,
+        `session=${sessionKey}`,
+        `score=${decision.metrics.score.toFixed(3)}`,
+        `novelty=${decision.metrics.novelty.toFixed(3)}`,
+        `lex=${decision.metrics.lexicalDistance.toFixed(3)}`,
+        `uniq=${decision.metrics.uniqueTokenRatio.toFixed(3)}`,
+        `entropy=${decision.metrics.entropy.toFixed(3)}`,
+        `sim=${typeof decision.metrics.similarity === "number" ? decision.metrics.similarity.toFixed(3) : "n/a"}`,
+        `embed=${decision.metrics.usedEmbedding ? "1" : "0"}`,
+        `pending=${state.pendingSoftSignals}`,
+        `baseline=${baselineTokens.size}`,
+        `textHash=${contentHash}`,
+        `tokens=${maybeJson(tokenList.slice(0, DEBUG_LOG_TOKEN_PREVIEW_COUNT))}`,
+        `text=${maybeJson(textPreview)}`,
+      ];
+      if (rawPreview !== textPreview) {
+        debugFields.push(`raw=${maybeJson(rawPreview)}`);
+      }
+      api.logger.debug(debugFields.join(" "));
     }
 
     if (decision.kind === "warmup") {