@joshuaswarren/openclaw-engram 9.3.4 → 9.3.6

package/openclaw.plugin.json

@@ -318,6 +318,63 @@
           }
         }
       },
+      "procedural": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {},
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "Master gate for procedural memory: extraction, recall boost, and mining (issue #519)."
+          },
+          "minOccurrences": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 1000,
+            "default": 3,
+            "description": "Minimum clustered trajectory occurrences before emitting a candidate procedure (0 disables mining)."
+          },
+          "successFloor": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "default": 0.7,
+            "description": "Minimum success-rate floor (from trajectory outcomes) for miner promotion."
+          },
+          "autoPromoteOccurrences": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 10000,
+            "default": 8,
+            "description": "When auto-promotion is enabled, minimum occurrence count to move pending_review procedures to active (0 disables auto-promotion by count)."
+          },
+          "autoPromoteEnabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "When true, miner may auto-promote trusted procedures to active after autoPromoteOccurrences."
+          },
+          "lookbackDays": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 3650,
+            "default": 30,
+            "description": "Trajectory lookback window for procedural mining."
+          },
+          "recallMaxProcedures": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10,
+            "default": 3,
+            "description": "Maximum procedure memories to inject on task-initiation recall."
+          },
+          "proceduralMiningCronAutoRegister": {
+            "type": "boolean",
+            "default": false,
+            "description": "When true, installer may register the nightly procedural mining cron job."
+          }
+        }
+      },
       "slotBehavior": {
         "type": "object",
         "additionalProperties": false,
@@ -1299,7 +1356,8 @@
             "principle",
             "commitment",
             "moment",
-            "skill"
+            "skill",
+            "procedure"
           ]
         },
         "default": [
@@ -1864,6 +1922,48 @@
         "default": true,
         "description": "Automatically supersede contradicted memories"
       },
+      "contradictionScan": {
+        "type": "object",
+        "description": "Configuration for the nightly contradiction-scan cron (issue #520)",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "Enable the nightly contradiction scan cron (disabled by default per rule 48)"
+          },
+          "similarityFloor": {
+            "type": "number",
+            "default": 0.82,
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Embedding cosine similarity floor for candidate pair generation"
+          },
+          "topicOverlapFloor": {
+            "type": "number",
+            "default": 0.4,
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Minimum topic-token Jaccard overlap for unstructured pairs"
+          },
+          "maxPairsPerRun": {
+            "type": "integer",
+            "default": 500,
+            "minimum": 1,
+            "description": "Cap on candidate pairs evaluated per cron run"
+          },
+          "cooldownDays": {
+            "type": "integer",
+            "default": 14,
+            "minimum": 0,
+            "description": "Cooldown in days. 0 = always re-evaluate."
+          },
+          "autoMergeDuplicates": {
+            "type": "boolean",
+            "default": false,
+            "description": "Auto-flag pairs judged duplicates for dedup (still requires user approval)"
+          }
+        }
+      },
       "temporalSupersessionEnabled": {
         "type": "boolean",
         "default": true,
@@ -1874,6 +1974,46 @@
         "default": false,
         "description": "If true, include temporally-superseded facts in recall results (for audit/history). Default: exclude."
       },
+      "recallDirectAnswerEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "When true, recall runs the direct-answer tier in observation mode: annotates LastRecallSnapshot.tierExplain with which tier would have served the query (issue #518). Does not short-circuit the QMD path in the current release."
+      },
+      "recallDirectAnswerTokenOverlapFloor": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.55,
+        "description": "Minimum query↔memory token-overlap ratio for direct-answer eligibility. Set to 0 to disable the gate."
+      },
+      "recallDirectAnswerImportanceFloor": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.7,
+        "description": "Minimum calibrated importance score for direct-answer eligibility. Set to 0 to disable the gate."
+      },
+      "recallDirectAnswerAmbiguityMargin": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.15,
+        "description": "If the second-best candidate scores within this ratio of the top, direct-answer defers to hybrid."
+      },
+      "recallDirectAnswerEligibleTaxonomyBuckets": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "default": [
+          "decisions",
+          "principles",
+          "conventions",
+          "runbooks",
+          "entities"
+        ],
+        "description": "Taxonomy category IDs eligible for direct-answer routing."
+      },
       "memoryLinkingEnabled": {
         "type": "boolean",
         "default": false,
@@ -2289,6 +2429,11 @@
         "default": 15000,
         "description": "Timeout for fast-tier local LLM requests (ms). Lower than primary since fast ops should complete quickly."
       },
+      "localLlmDisableThinking": {
+        "type": "boolean",
+        "default": true,
+        "description": "When true (default), request chain-of-thought / thinking-mode suppression on the main local LLM (issue #548). The `chat_template_kwargs: { enable_thinking: false }` field is only injected when the detected backend is known to support it (LM Studio, vLLM); strict OpenAI-compat backends fail open to avoid the 400-cooldown path. Structured-output tasks like extraction and consolidation gain nothing from reasoning tokens and thinking-capable models (Qwen 3.5, Gemma 4, DeepSeek) often blow the 60s timeout before emitting content. Set to false to restore thinking for narrative tasks. The fast-tier client always disables thinking and is not affected by this flag."
+      },
       "hourlySummaryCronAutoRegister": {
         "type": "boolean",
         "default": false,
@@ -2560,7 +2705,8 @@
         },
         "default": [
           "correction",
-          "commitment"
+          "commitment",
+          "procedure"
         ],
         "description": "Memory categories excluded from semantic consolidation."
       },
@@ -2973,7 +3119,8 @@
           "commitment",
           "preference",
           "decision",
-          "principle"
+          "principle",
+          "procedure"
         ],
         "description": "Categories that protect a fact from archival regardless of other criteria."
       },
@@ -3011,7 +3158,8 @@
           "decision",
           "principle",
           "commitment",
-          "preference"
+          "preference",
+          "procedure"
         ],
         "description": "Categories that lifecycle policy will not auto-archive."
       },
@@ -3589,6 +3737,7 @@
       },
       "briefing": {
         "type": "object",
+        "additionalProperties": false,
         "default": {
           "enabled": true,
           "defaultWindow": "yesterday",
@@ -3599,6 +3748,52 @@
           "saveDir": null,
           "llmFollowups": true
         },
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          },
+          "defaultWindow": {
+            "type": "string",
+            "default": "yesterday"
+          },
+          "defaultFormat": {
+            "type": "string",
+            "enum": [
+              "markdown",
+              "json"
+            ],
+            "default": "markdown"
+          },
+          "maxFollowups": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 10,
+            "default": 5
+          },
+          "calendarSource": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "default": null
+          },
+          "saveByDefault": {
+            "type": "boolean",
+            "default": false
+          },
+          "saveDir": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "default": null
+          },
+          "llmFollowups": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         "description": "Daily Context Briefing (#370). Knobs: enabled, defaultWindow ('yesterday', '3d', '1w', '24h', ...), defaultFormat (markdown|json), maxFollowups (0-10), calendarSource (path to ICS/JSON file, null = off), saveByDefault, saveDir (null = $REMNIC_HOME/briefings/), llmFollowups (disable to skip Responses API calls)."
       },
       "enrichmentEnabled": {
@@ -3901,6 +4096,10 @@
       "label": "Auto-Resolve Contradictions",
       "help": "Automatically supersede old memories when contradiction is confirmed"
     },
+    "contradictionScan": {
+      "label": "Contradiction Scan",
+      "help": "Nightly cron that pairs similar memories and flags contradictions for review (issue #520)"
+    },
     "temporalSupersessionEnabled": {
       "label": "Temporal Supersession",
       "help": "Mark older facts superseded when a newer fact writes a conflicting value for the same entityRef + structured attribute (issue #375)"
@@ -3910,6 +4109,30 @@
       "advanced": true,
       "help": "If enabled, superseded facts still surface in recall (audit/history mode)."
     },
+    "recallDirectAnswerEnabled": {
+      "label": "Direct-Answer Retrieval Tier",
+      "help": "Route validated high-trust queries to a fast direct-answer path before QMD (issue #518)."
+    },
+    "recallDirectAnswerTokenOverlapFloor": {
+      "label": "Direct-Answer Token Overlap Floor",
+      "advanced": true,
+      "placeholder": "0.55"
+    },
+    "recallDirectAnswerImportanceFloor": {
+      "label": "Direct-Answer Importance Floor",
+      "advanced": true,
+      "placeholder": "0.7"
+    },
+    "recallDirectAnswerAmbiguityMargin": {
+      "label": "Direct-Answer Ambiguity Margin",
+      "advanced": true,
+      "placeholder": "0.15"
+    },
+    "recallDirectAnswerEligibleTaxonomyBuckets": {
+      "label": "Direct-Answer Eligible Taxonomy Buckets",
+      "advanced": true,
+      "help": "Taxonomy category IDs eligible for direct-answer routing."
+    },
     "memoryLinkingEnabled": {
       "label": "Memory Linking",
       "help": "Build knowledge graph by linking related memories"
@@ -4111,6 +4334,11 @@
       "advanced": true,
       "help": "Timeout for fast-tier requests. Lower than primary since fast ops should complete quickly."
     },
+    "localLlmDisableThinking": {
+      "label": "Disable Local LLM Thinking Mode",
+      "advanced": true,
+      "help": "Suppress chain-of-thought reasoning on the main local LLM. Default on — extraction / consolidation are structured-output tasks where thinking is pure latency tax and a common cause of 60s timeouts on Qwen 3.5 / Gemma 4 / DeepSeek. The suppression field (chat_template_kwargs) is only sent when the backend is known to support it (LM Studio, vLLM); strict OpenAI-compat backends fail open. Turn off if you want thinking on narrative tasks. Fast-tier client always disables thinking regardless."
+    },
     "evalHarnessEnabled": {
       "label": "Evaluation Harness",
       "help": "Enable Engram's benchmark/evaluation harness foundation and benchmark-status diagnostics."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshuaswarren/openclaw-engram",
-  "version": "9.3.4",
+  "version": "9.3.6",
   "description": "Deprecated compatibility shim for Engram installs. Re-exports @remnic/plugin-openclaw and forwards engram-access to @remnic/core.",
   "type": "module",
   "main": "dist/index.js",
@@ -31,8 +31,8 @@
     ]
   },
   "dependencies": {
-    "@remnic/core": "^1.0.2",
-    "@remnic/plugin-openclaw": "^1.0.5"
+    "@remnic/core": "^1.1.0",
+    "@remnic/plugin-openclaw": "^1.0.7"
   },
   "peerDependencies": {
     "openclaw": ">=2026.4.8"