openclaw.plugin.json

{
  "id": "openclaw-remnic",
  "name": "Remnic OpenClaw Plugin",
  "version": "9.3.671",
  "kind": "memory",
  "description": "Local semantic memory for OpenClaw with bundled Remnic core runtime. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
  "setup": {
    "requiresRuntime": false,
    "providers": [
      {
        "id": "openai",
        "authMethods": [
          "api-key"
        ],
        "envVars": [
          "OPENAI_API_KEY"
        ]
      }
    ]
  },
  "providerAuthChoices": [
    {
      "provider": "openai",
      "method": "api-key",
      "choiceId": "remnic-openai-api-key",
      "choiceLabel": "Optional OpenAI API key for Remnic plugin-mode extraction",
      "choiceHint": "Not needed when Remnic uses the OpenClaw gateway model source. Set only if you intentionally use plugin mode with OpenAI or an OpenAI-compatible endpoint.",
      "groupId": "remnic-memory",
      "groupLabel": "Remnic memory",
      "optionKey": "openaiApiKey",
      "cliFlag": "--openai-api-key",
      "cliOption": "--openai-api-key <key>",
      "cliDescription": "Optional OpenAI API key used by Remnic plugin-mode extraction, consolidation, and embedding flows.",
      "onboardingScopes": [
        "text-inference"
      ]
    }
  ],
  "providerAuthEnvVars": {
    "openai": [
      "OPENAI_API_KEY"
    ]
  },
  "supports": {
    "memorySlot": true,
    "dreamingSlot": true,
    "activeMemory": true,
    "heartbeat": true,
    "commandsList": true,
    "beforeReset": true
  },
  "contracts": {
    "tools": [
      "compounding_promote_candidate",
      "compounding_weekly_synthesize",
      "compression_guidelines_activate",
      "compression_guidelines_optimize",
      "context_checkpoint",
      "continuity_audit_generate",
      "continuity_incident_close",
      "continuity_incident_list",
      "continuity_incident_open",
      "continuity_loop_add_or_update",
      "continuity_loop_review",
      "conversation_index_update",
      "engram_context_describe",
      "engram_context_expand",
      "engram_context_search",
      "engram_profiling_report",
      "identity_anchor_get",
      "identity_anchor_update",
      "memory_action_apply",
      "memory_capture",
      "memory_entities",
      "memory_feedback",
      "memory_feedback_last_recall",
      "memory_get",
      "memory_governance_run",
      "memory_graph_explain_last_recall",
      "memory_identity",
      "memory_intent_debug",
      "memory_last_recall",
      "memory_profile",
      "memory_promote",
      "memory_qmd_debug",
      "memory_questions",
      "memory_search",
      "memory_store",
      "memory_summarize_hourly",
      "remnic_context_describe",
      "remnic_context_expand",
      "remnic_context_search",
      "remnic_profiling_report",
      "shared_context_cross_signals_run",
      "shared_context_curate_daily",
      "shared_context_write_output",
      "shared_feedback_record",
      "shared_priorities_append",
      "work_board",
      "work_project",
      "work_task"
    ]
  },
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "openaiApiKey": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "const": false
          }
        ],
        "description": "Optional OpenAI API key for plugin mode (or set OPENAI_API_KEY env var). Ignored by default gateway-mode installs; in plugin mode, Remnic may send conversation and memory content to OpenAI or the configured OpenAI-compatible endpoint for extraction, consolidation, summarization, and embeddings."
      },
      "openaiBaseUrl": {
        "type": "string",
        "description": "Set the OpenAI API base URL for OpenAI-compatible providers (Scryr, Together, OpenRouter, etc.)"
      },
      "model": {
        "type": "string",
        "default": "gpt-5.5",
        "description": "OpenAI model for extraction/consolidation"
      },
      "reasoningEffort": {
        "type": "string",
        "enum": [
          "none",
          "low",
          "medium",
          "high"
        ],
        "default": "low",
        "description": "Reasoning effort for extraction"
      },
      "triggerMode": {
        "type": "string",
        "enum": [
          "smart",
          "every_n",
          "time_based"
        ],
        "default": "smart",
        "description": "Buffer trigger mode"
      },
      "bufferMaxTurns": {
        "type": "number",
        "default": 5,
        "description": "Max turns before forced extraction"
      },
      "bufferMaxMinutes": {
        "type": "number",
        "default": 15,
        "description": "Max minutes before forced extraction"
      },
      "bufferSurpriseTriggerEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Issue #563 (D-MEM). When true, the smart buffer flushes immediately on turns whose embedding-based surprise score exceeds bufferSurpriseThreshold, in addition to the existing turn-count / signal / time triggers. Additive only — never suppresses existing flushes. Off by default."
      },
      "bufferSurpriseThreshold": {
        "type": "number",
        "default": 0.35,
        "minimum": 0,
        "maximum": 1,
        "description": "Threshold in [0, 1] above which a surprise score flushes the buffer. Higher = require more novelty to flush. Ignored when bufferSurpriseTriggerEnabled is false."
      },
      "bufferSurpriseK": {
        "type": "number",
        "default": 5,
        "minimum": 1,
        "description": "Number of nearest-neighbor memories to average over when computing the surprise score. Clamped to the recent-memory window size."
      },
      "bufferSurpriseRecentMemoryCount": {
        "type": "number",
        "default": 20,
        "minimum": 0,
        "description": "Maximum number of recent memories sampled for surprise scoring. Bounds embedding cost per turn. Set to 0 to effectively disable the trigger even when the flag is on."
      },
      "bufferSurpriseProbeTimeoutMs": {
        "type": "number",
        "default": 2000,
        "minimum": 1,
        "description": "Hard timeout (ms) for the surprise probe. If the probe does not resolve within this window the buffer treats it as failed and falls through to the existing triggers — a slow or hung embedder cannot stall the turn-append path."
      },
      "consolidateEveryN": {
        "type": "number",
        "default": 3,
        "description": "Run consolidation every N extractions"
      },
      "highSignalPatterns": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Custom regex patterns for immediate extraction"
      },
      "maxMemoryTokens": {
        "type": "number",
        "default": 2000,
        "description": "Max memory-context tokens per turn"
      },
      "memoryOsPreset": {
        "type": "string",
        "enum": [
          "conservative",
          "balanced",
          "research",
          "research-max",
          "local-llm-heavy"
        ],
        "description": "Optional named preset that seeds Engram's advanced config surface before explicit per-setting settings are applied. `research` is accepted as a backward-compatible alias for `research-max`."
      },
      "qmdEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Use QMD for search"
      },
      "qmdCollection": {
        "type": "string",
        "default": "openclaw-engram",
        "description": "QMD collection name"
      },
      "qmdMaxResults": {
        "type": "number",
        "default": 8,
        "description": "Max QMD results per search"
      },
      "qmdColdTierEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable cold-tier QMD recall from a secondary collection when hot recall misses"
      },
      "qmdColdCollection": {
        "type": "string",
        "default": "openclaw-engram-cold",
        "description": "Secondary QMD collection name used for cold-tier fallback recall"
      },
      "qmdColdMaxResults": {
        "type": "number",
        "default": 8,
        "description": "Max cold-tier QMD results considered before final recall cap"
      },
      "qmdTierMigrationEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable value-aware migration between hot and cold QMD tiers"
      },
      "qmdTierDemotionMinAgeDays": {
        "type": "number",
        "default": 14,
        "description": "Minimum hot-memory age in days before tier demotion is eligible"
      },
      "qmdTierDemotionValueThreshold": {
        "type": "number",
        "default": 0.35,
        "description": "Value-score threshold at or below which hot memories are eligible for cold demotion"
      },
      "qmdTierPromotionValueThreshold": {
        "type": "number",
        "default": 0.7,
        "description": "Value-score threshold at or above which cold memories are eligible for hot promotion"
      },
      "qmdTierParityGraphEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Apply graph-assist parity checks across hot and cold retrieval tiers"
      },
      "qmdTierParityHiMemEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Apply HiMem episode/note parity checks across hot and cold retrieval tiers"
      },
      "qmdTierAutoBackfillEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Allow automated cold-tier backfill jobs to repair parity gaps"
      },
      "qmdSupportedVersion": {
        "type": "string",
        "default": "2.5.3",
        "description": "Highest QMD version this Remnic build will auto-install"
      },
      "qmdAutoUpgradeEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Opt-in auto-upgrade for PATH/fallback QMD installs"
      },
      "qmdAutoUpgradeCheckIntervalMs": {
        "type": "number",
        "minimum": 60000,
        "default": 86400000,
        "description": "Minimum interval between QMD auto-upgrade checks"
      },
      "qmdChunkStrategy": {
        "type": "string",
        "enum": [
          "auto",
          "regex"
        ],
        "default": "auto",
        "description": "QMD chunk strategy forwarded when the installed QMD supports it"
      },
      "qmdCandidateLimit": {
        "type": "number",
        "minimum": 1,
        "description": "Optional candidate limit forwarded to supported QMD query paths"
      },
      "qmdQueryRerankEnabled": {
        "type": "boolean",
        "default": true,
        "description": "When false, ask supported QMD versions to skip the built-in rerank step"
      },
      "qmdSearchStrategy": {
        "type": "string",
        "enum": [
          "hybrid",
          "lex-vec",
          "lex"
        ],
        "default": "hybrid",
        "description": "Daemon search plan. 'hybrid' (default) runs lex+vec+hyde for best recall; 'lex-vec' drops the expensive HyDE generate leg; 'lex' is BM25-only (fastest). Lower tiers trade recall for latency on CPU-only models. Default preserves existing behavior (issue #1335)."
      },
      "qmdSubprocessStrategy": {
        "type": "string",
        "enum": [
          "query",
          "search"
        ],
        "default": "query",
        "description": "Command for the QMD CLI subprocess fallback, used only when the daemon is unavailable. 'query' (default) keeps LLM query expansion + rerank; 'search' is BM25-only and faster on very large collections but loses expansion/rerank. Default preserves existing behavior (issue #1335)."
      },
      "qmdDaemonTimeoutMs": {
        "type": "number",
        "minimum": 1000,
        "maximum": 120000,
        "default": 8000,
        "description": "Per-call timeout (ms) for QMD daemon searches. Default 8000; raise (e.g. 20000) to give CPU-only HyDE queries more headroom before the daemon call times out (issue #1335)."
      },
      "qmdIndexName": {
        "type": "string",
        "description": "Optional QMD named index forwarded as qmd --index <name> when supported. Leave unset during upgrades unless existing QMD data already lives in that named index."
      },
      "qmdForceCpu": {
        "type": "boolean",
        "default": false,
        "description": "Set QMD_FORCE_CPU=1 for QMD child processes to bypass GPU probing and run predictably on CPU"
      },
      "qmdGpuBackend": {
        "type": [
          "string",
          "boolean"
        ],
        "enum": [
          "auto",
          "metal",
          "cuda",
          "vulkan",
          "false",
          false
        ],
        "description": "Optional QMD_LLAMA_GPU override for QMD child processes"
      },
      "qmdEmbedParallelism": {
        "type": "number",
        "minimum": 1,
        "maximum": 8,
        "description": "Optional QMD_EMBED_PARALLELISM override, clamped to 1-8"
      },
      "qmdEmbedModel": {
        "type": "string",
        "description": "Optional QMD_EMBED_MODEL override"
      },
      "qmdRerankModel": {
        "type": "string",
        "description": "Optional QMD_RERANK_MODEL override"
      },
      "qmdGenerateModel": {
        "type": "string",
        "description": "Optional QMD_GENERATE_MODEL override"
      },
      "embeddingFallbackEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable embedding-based semantic recall fallback when QMD is unavailable or returns no matches"
      },
      "embeddingFallbackProvider": {
        "type": "string",
        "enum": [
          "auto",
          "openai",
          "local"
        ],
        "default": "auto",
        "description": "Embedding provider selection for semantic fallback"
      },
      "hostEmbeddingProviderEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Prefer OpenClaw host-registered embedding providers for Remnic's semantic fallback and embedded vector backends when the OpenClaw SDK exposes them. Falls back to Remnic's existing embedding provider path on older hosts or provider setup failures."
      },
      "hostEmbeddingProviderId": {
        "type": "string",
        "description": "Optional OpenClaw embedding provider adapter id to use. Leave unset for automatic selection from OpenClaw's memory/generic embedding provider registry."
      },
      "hostEmbeddingProviderModel": {
        "type": "string",
        "description": "Optional embedding model id passed to the selected OpenClaw host embedding provider."
      },
      "embeddingFallbackModel": {
        "type": "string",
        "description": "Optional model identifier for embedding fallback requests. Defaults to localLlmModel for legacy installs."
      },
      "qmdPath": {
        "type": "string",
        "description": "Optional absolute path to qmd binary (bypasses PATH/fallback discovery)"
      },
      "memoryDir": {
        "type": "string",
        "description": "Override memory storage directory"
      },
      "entitySchemas": {
        "type": "object",
        "description": "Optional per-entity-type structured section schema customizations.",
        "additionalProperties": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "sections": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "aliases": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "anyOf": [
                  {
                    "required": [
                      "key"
                    ]
                  },
                  {
                    "required": [
                      "title"
                    ]
                  }
                ]
              }
            }
          },
          "required": [
            "sections"
          ]
        }
      },
      "dreaming": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false
          },
          "journalPath": {
            "type": "string",
            "default": "DREAMS.md"
          },
          "maxEntries": {
            "anyOf": [
              {
                "type": "integer",
                "const": 0
              },
              {
                "type": "integer",
                "minimum": 10,
                "maximum": 10000
              }
            ],
            "default": 500
          },
          "injectRecentCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20,
            "default": 3
          },
          "minIntervalMinutes": {
            "type": "integer",
            "minimum": 1,
            "default": 120
          },
          "narrativeModel": {
            "type": "string",
            "default": "",
            "description": "Model used to write dream-journal narratives. Under modelSource=plugin this must be an OpenAI model id used with the direct OpenAI key. Under modelSource=gateway it accepts a provider-qualified id (e.g. zai/glm-4.7-flash) routed through gateway providers — no direct OpenAI key required; leave empty to fall back to taskModelChain / the gateway default chain."
          },
          "narrativePromptStyle": {
            "type": "string",
            "enum": [
              "reflective",
              "diary",
              "analytical"
            ],
            "default": "reflective"
          },
          "watchFile": {
            "type": "boolean",
            "default": true
          }
        }
      },
      "dreams": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "description": "Consolidation pipeline phases config (issue #678 PR 2). Groups existing lifecycle/REM/deep-sleep gates under a unified namespace. Values here WIN over equivalent legacy top-level keys when set. See docs/dreams.md. (Note: distinct from the `dreaming` diary-surface config.)",
        "properties": {
          "phases": {
            "type": "object",
            "additionalProperties": false,
            "default": {},
            "properties": {
              "lightSleep": {
                "type": "object",
                "additionalProperties": false,
                "default": {},
                "description": "Light-sleep phase: recent activity scoring and clustering. Mirrors lifecyclePolicyEnabled and related thresholds when not set explicitly.",
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "Master switch for the light-sleep phase. Mirrors lifecyclePolicyEnabled when not set."
                  },
                  "cadenceMs": {
                    "type": "integer",
                    "minimum": 0,
                    "default": 0,
                    "description": "Minimum interval between light-sleep passes (ms). 0 = no override; orchestrator uses its internal cadence."
                  },
                  "promoteHeatThreshold": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "default": 0.55,
                    "description": "Value score above which a memory is treated as hot. Mirrors lifecyclePromoteHeatThreshold when not set."
                  },
                  "staleDecayThreshold": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "default": 0.65,
                    "description": "Value score below which a memory starts to decay. Mirrors lifecycleStaleDecayThreshold when not set."
                  },
                  "archiveDecayThreshold": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "default": 0.85,
                    "description": "Value score below which a memory is eligible for archive. Mirrors lifecycleArchiveDecayThreshold when not set."
                  },
                  "filterStaleEnabled": {
                    "type": "boolean",
                    "default": false,
                    "description": "Whether stale memories are filtered from recall. Mirrors lifecycleFilterStaleEnabled when not set."
                  }
                }
              },
              "rem": {
                "type": "object",
                "additionalProperties": false,
                "default": {},
                "description": "REM phase: cross-session synthesis, supersession resolution, semantic consolidation. Mirrors semanticConsolidation* keys when not set explicitly.",
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "Master switch for the REM phase. Mirrors semanticConsolidationEnabled when not set."
                  },
                  "cadenceMs": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "How often the REM pass runs (ms). Derived from semanticConsolidationIntervalHours when not set."
                  },
                  "similarityThreshold": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "default": 0.8,
                    "description": "Cosine-similarity threshold for cluster membership. Mirrors semanticConsolidationThreshold when not set."
                  },
                  "minClusterSize": {
                    "type": "integer",
                    "minimum": 2,
                    "default": 3,
                    "description": "Minimum cluster size before consolidation runs. Mirrors semanticConsolidationMinClusterSize when not set."
                  },
                  "maxPerRun": {
                    "type": "integer",
                    "minimum": 0,
                    "default": 100,
                    "description": "Max cluster operations per run. Mirrors semanticConsolidationMaxPerRun when not set."
                  },
                  "minIntervalMs": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Minimum gap between consolidation passes (ms). Mirrors consolidationMinIntervalMs when not set."
                  }
                }
              },
              "deepSleep": {
                "type": "object",
                "additionalProperties": false,
                "default": {},
                "description": "Deep-sleep phase: promotion to durable memory, hot-to-cold tier migration, page-version snapshots, archive. Mirrors versioningEnabled and related keys when not set explicitly.",
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "default": false,
                    "description": "Master switch for the deep-sleep phase. Defaults false unless legacy deep-sleep surfaces are explicitly enabled; set true to allow nightly governance, tier migration, and versioning surfaces."
                  },
                  "cadenceMs": {
                    "type": "integer",
                    "minimum": 0,
                    "default": 86400000,
                    "description": "Minimum interval between deep-sleep passes (ms). Default 86400000 (24h). Informational in PR 2; PR 4 wires this into the cron scheduler."
                  },
                  "versioningEnabled": {
                    "type": "boolean",
                    "description": "Enable page-version snapshots on every overwrite. Mirrors versioningEnabled when not set."
                  },
                  "versioningMaxPerPage": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Max snapshots per memory page. Mirrors versioningMaxPerPage when not set."
                  }
                }
              }
            }
          }
        }
      },
      "heartbeat": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false
          },
          "journalPath": {
            "type": "string",
            "default": "HEARTBEAT.md"
          },
          "maxPreviousRuns": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20,
            "default": 5
          },
          "watchFile": {
            "type": "boolean",
            "default": true
          },
          "detectionMode": {
            "type": "string",
            "enum": [
              "runtime-signal",
              "heuristic",
              "auto"
            ],
            "default": "auto"
          },
          "gateExtractionDuringHeartbeat": {
            "type": "boolean",
            "default": true
          }
        }
      },
      "codingMode": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "description": "Coding-agent project/branch scoping (issue #569).",
        "properties": {
          "projectScope": {
            "type": "boolean",
            "default": true,
            "description": "When true and the session has a resolved git context, memory routes to a project-scoped namespace (project:<id>). Set to false to restore pre-#569 behaviour exactly."
          },
          "branchScope": {
            "type": "boolean",
            "default": false,
            "description": "When true, memory also overlays the current branch (project:<id>/branch:<name>). Opt-in — most development wants cross-branch recall. Wired in PR 3 of #569."
          },
          "globalFallback": {
            "type": "boolean",
            "default": true,
            "description": "When true (default), project-scoped sessions include the root/default namespace in read fallbacks so globally useful memories remain visible. Set to false for strict project isolation."
          }
        }
      },
      "codingKnowledge": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "description": "Durable coding-knowledge surface — Track A of issue #1548. Master gate + per-feature switches for decision records, architecture card, session delta, and structural-context provider. Off by default so pre-feature byte-identical behaviour is preserved when disabled.",
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false,
            "description": "Master gate. Off (default) means no Track A surface fires and no new tools / briefing lines / state directories appear. On enables the switches below."
          },
          "decisionRecords": {
            "type": "boolean",
            "default": true,
            "description": "Decision-record surfaces (list/record/supersede) + briefing titles of standing decisions. Effective only under the master gate."
          },
          "architectureCard": {
            "type": "boolean",
            "default": true,
            "description": "Architecture-card build/refresh + briefing injection. Effective only under the master gate."
          },
          "sessionDelta": {
            "type": "boolean",
            "default": true,
            "description": "Last-seen-head persistence + delta briefing line. Effective only under the master gate."
          },
          "architectureCardLlmSummary": {
            "type": "boolean",
            "default": false,
            "description": "Opt-in LLM summary pass on the architecture card. Costs tokens; default off (rule 48). Effective only under the master and card gates."
          },
          "structuralProvider": {
            "type": "string",
            "enum": [
              "none",
              "subprocess",
              "native"
            ],
            "default": "none",
            "description": "Structural-context provider selection: \"none\" (default) keeps review-context file-path-only, \"subprocess\" shells out to structuralProviderCommand via execFile (argv array), \"native\" adapts the in-family engine when @remnic/coding-graph is installed."
          },
          "structuralProviderCommand": {
            "type": "string",
            "default": "",
            "description": "Absolute path to the subprocess binary when structuralProvider = \"subprocess\". Empty string = no command configured. The consumer validates existence at boot (rule 24)."
          }
        }
      },
      "procedural": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": true,
            "description": "Master gate for procedural memory: extraction, recall boost, and mining (issue #519). Default-on since issue #567 PR 4/5; set to `false` to opt out."
          },
          "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.75,
            "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": 14,
            "description": "Trajectory lookback window for procedural mining."
          },
          "recallMaxProcedures": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10,
            "default": 2,
            "description": "Maximum procedure memories to add on task-initiation recall."
          },
          "proceduralMiningCronAutoRegister": {
            "type": "boolean",
            "default": false,
            "description": "When true, installer may register the nightly procedural mining cron job."
          }
        }
      },
      "wearables": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "description": "Wearable transcript ingestion (Limitless / Bee / Omi). Connector packages install a la carte: @remnic/connector-limitless, @remnic/connector-bee, @remnic/connector-omi. See docs/wearables.md.",
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false,
            "description": "Master gate for the wearables subsystem."
          },
          "timezone": {
            "type": "string",
            "description": "IANA timezone used to bucket transcripts into days. Defaults to the host timezone."
          },
          "redactionEnabled": {
            "type": "boolean",
            "default": true,
            "description": "Redact SSN / payment-card patterns from transcripts before storage and extraction."
          },
          "redactionPatterns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Additional user-supplied redaction regexes (validated at config load)."
          },
          "offTheRecordEnabled": {
            "type": "boolean",
            "default": true,
            "description": "Honor a spoken 'off the record' marker by eliding segments until 'back on the record'."
          },
          "digestEnabled": {
            "type": "boolean",
            "default": true,
            "description": "Write one compact daily-digest memory per synced source/day."
          },
          "autoSyncEnabled": {
            "type": "boolean",
            "default": true,
            "description": "Periodically refresh transcripts in-process on long-lived hosts. Every tick re-syncs a rolling window ending today (existing day files included)."
          },
          "autoSyncIntervalMinutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1440,
            "default": 15,
            "description": "Minutes between auto-sync ticks."
          },
          "autoSyncDays": {
            "type": "integer",
            "minimum": 1,
            "maximum": 90,
            "default": 2,
            "description": "Rolling window (days ending today) refreshed on each auto-sync tick."
          },
          "autoSyncDeepDays": {
            "type": "integer",
            "minimum": 0,
            "maximum": 90,
            "default": 7,
            "description": "Once-per-local-day deep refresh window (days) for late uploads and provider re-processing. 0 disables; otherwise must be >= autoSyncDays."
          },
          "corrections": {
            "type": "array",
            "default": [],
            "description": "User-specific transcript correction rules applied on every sync (merged with CLI-managed rules).",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "match",
                "replace"
              ],
              "properties": {
                "match": {
                  "type": "string",
                  "description": "Text (or regex when regex=true) to match."
                },
                "replace": {
                  "type": "string",
                  "description": "Replacement text."
                },
                "regex": {
                  "type": "boolean",
                  "default": false,
                  "description": "Treat match as a regular expression."
                },
                "caseInsensitive": {
                  "type": "boolean",
                  "default": true,
                  "description": "Case-insensitive matching."
                },
                "sources": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Restrict the rule to specific source ids."
                }
              }
            }
          },
          "sources": {
            "type": "object",
            "default": {},
            "description": "Per-source settings keyed by connector id (limitless, bee, omi, or a custom connector id).",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "enabled": {
                  "type": "boolean",
                  "default": false,
                  "description": "Enable syncing from this wearable source."
                },
                "apiKey": {
                  "type": "string",
                  "description": "Provider API credential. Prefer the per-connector environment variable (e.g. ${LIMITLESS_API_KEY}); a config value takes precedence when both are set."
                },
                "baseUrl": {
                  "type": "string",
                  "description": "Override the provider base URL (self-hosted / local-proxy setups, e.g. the Bee local proxy)."
                },
                "appId": {
                  "type": "string",
                  "description": "Omi only: integration app id (the {app_id} path component of the Omi Integrations API)."
                },
                "userId": {
                  "type": "string",
                  "description": "Omi only: target user id supplied as the uid query parameter."
                },
                "memoryMode": {
                  "type": "string",
                  "enum": [
                    "off",
                    "review",
                    "auto",
                    "smart"
                  ],
                  "default": "smart",
                  "description": "Memory creation trust gate: smart (default) = LLM-judge + per-source trust prior + cross-device corroboration decide active/review/drop automatically; off = transcripts only; review = every candidate lands pending_review; auto = deterministic gates only, survivors active."
                },
                "sourceTrust": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "default": 0.8,
                  "description": "Trust prior for this source's transcription quality (0..1). Multiplies extraction confidence in smart mode — lower it for a device that mis-transcribes often."
                },
                "autoApproveTrust": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "default": 0.7,
                  "description": "Smart mode: trust score at/above which facts are written active."
                },
                "reviewTrust": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "default": 0.45,
                  "description": "Smart mode: trust score at/above which borderline facts are queued for review instead of dropped. Must be below autoApproveTrust."
                },
                "minConfidence": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "default": 0.6,
                  "description": "Drop extracted facts below this confidence."
                },
                "minImportance": {
                  "type": "string",
                  "enum": [
                    "trivial",
                    "low",
                    "normal",
                    "high",
                    "critical"
                  ],
                  "default": "low",
                  "description": "Drop extracted facts scored below this importance level."
                },
                "maxMemoriesPerDay": {
                  "type": "integer",
                  "minimum": 0,
                  "default": 0,
                  "description": "Cap on memories created per source per day. 0 (the default) disables the cap."
                },
                "importNativeMemories": {
                  "type": "string",
                  "enum": [
                    "off",
                    "review",
                    "smart"
                  ],
                  "default": "smart",
                  "description": "Import provider-extracted memories (Bee facts / Omi memories): smart (default) routes them through the same judge + trust pipeline with a reduced prior; review always queues; off skips."
                },
                "cleanup": {
                  "type": "object",
                  "additionalProperties": false,
                  "default": {},
                  "properties": {
                    "mergeSameSpeaker": {
                      "type": "boolean",
                      "default": true,
                      "description": "Merge consecutive same-speaker segments."
                    },
                    "stripFillers": {
                      "type": "boolean",
                      "default": true,
                      "description": "Strip standalone filler tokens (um, uh, ...)."
                    },
                    "collapseRepeats": {
                      "type": "boolean",
                      "default": true,
                      "description": "Collapse immediately repeated phrases (ASR stutter)."
                    },
                    "dropLowQuality": {
                      "type": "boolean",
                      "default": true,
                      "description": "Drop segments that look like ASR garbage."
                    }
                  }
                }
              }
            }
          }
        }
      },
      "secureStoreEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable at-rest AES-256-GCM encryption for memory files (issue #690). When true, the daemon reads and writes memory files through the secure-fs layer. The store must be unlocked via `remnic secure-store unlock` after each daemon start. Default false."
      },
      "secureStoreEncryptOnWrite": {
        "type": "boolean",
        "default": true,
        "description": "When secureStoreEnabled is true, encrypt new memory writes. Set to false to pause new encryptions while still decrypting existing encrypted files (useful during incremental migration). Default true."
      },
      "slotBehavior": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "properties": {
          "requireExclusiveMemorySlot": {
            "type": "boolean",
            "default": true
          },
          "onSlotMismatch": {
            "type": "string",
            "enum": [
              "error",
              "warn",
              "silent"
            ],
            "default": "error"
          }
        }
      },
      "beforeResetTimeoutMs": {
        "type": "integer",
        "minimum": 100,
        "maximum": 30000,
        "default": 2000,
        "description": "Maximum time to wait for a reset-triggered flush before returning control to OpenClaw."
      },
      "initGateTimeoutMs": {
        "type": "integer",
        "minimum": 1000,
        "maximum": 120000,
        "default": 30000,
        "description": "Maximum time Remnic waits for cold-start initialization during recall; also registered as the OpenClaw before_prompt_build hook timeout on SDKs that support per-hook options."
      },
      "flushOnResetEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Flush buffered turns through extraction when OpenClaw resets a session."
      },
      "commandsListEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Advertise Remnic slash-command descriptors through the registerCommand runtime surface."
      },
      "openclawToolsEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Register the OpenClaw memory.search and memory.get tool adapters."
      },
      "openclawToolSnippetMaxChars": {
        "type": "integer",
        "minimum": 80,
        "maximum": 4000,
        "default": 600,
        "description": "Maximum snippet size returned by the OpenClaw memory tool adapters."
      },
      "openclawMessageReceivedCaptureEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Capture OpenClaw message_received hook content into transcripts when that hook is emitted by the host. Older OpenClaw versions that never emit the hook continue through agent_end capture."
      },
      "openclawReplyMetadataCaptureEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Persist bounded OpenClaw messageId, threadId, replyToId, replyToBody, and replyToSender fields in transcript metadata when available."
      },
      "openclawReplyMetadataExtractionHintsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "When true, prepend bounded quoted-reply context to user turns before Remnic extraction. Leave false to store reply metadata without changing extraction behavior."
      },
      "openclawChannelEnvelopeCleaningEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Use OpenClaw's canonical chat-channel envelope prefixes when the SDK exposes plugin-sdk/chat-channel-ids, while keeping the legacy OpenClaw-only cleaner on older hosts."
      },
      "openclawFlushPlanProcessingEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Process OpenClaw's append-only Remnic flush-plan file through Remnic extraction and clear processed content. Disable this if a future OpenClaw release owns flush-plan consumption and cleanup natively."
      },
      "sessionTogglesEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable per-session recall toggle state for OpenClaw runtime surfaces."
      },
      "verboseRecallVisibility": {
        "type": "boolean",
        "default": true,
        "description": "Allow verbose recall headers to surface runtime recall diagnostics in prompts."
      },
      "recallTranscriptsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Write JSONL recall audit transcripts for runtime recall-context assembly."
      },
      "recallTranscriptRetentionDays": {
        "type": "integer",
        "minimum": 1,
        "maximum": 365,
        "default": 30,
        "description": "Days of runtime recall audit transcripts to retain before pruning."
      },
      "respectBundledActiveMemoryToggle": {
        "type": "boolean",
        "default": true,
        "description": "Honor the bundled active-memory session toggle file when resolving Remnic recall toggles."
      },
      "activeRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable the OpenClaw active-recall context surface."
      },
      "activeRecallAgents": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional allowlist of OpenClaw agent ids that may use active recall."
      },
      "activeRecallAllowedChatTypes": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "direct",
            "group",
            "channel"
          ]
        },
        "default": [
          "direct",
          "group",
          "channel"
        ],
        "description": "OpenClaw chat types eligible for active recall."
      },
      "activeRecallQueryMode": {
        "type": "string",
        "enum": [
          "recent",
          "message",
          "full"
        ],
        "default": "recent",
        "description": "How much recent OpenClaw conversation context is fed into the active-recall query builder."
      },
      "activeRecallPromptStyle": {
        "type": "string",
        "enum": [
          "balanced",
          "strict",
          "contextual",
          "recall-heavy",
          "precision-heavy",
          "preference-only"
        ],
        "default": "balanced",
        "description": "Context assembly style for the active-recall surface."
      },
      "activeRecallCustomInstruction": {
        "type": "string",
        "description": "Optional custom guidance for the active-recall builder."
      },
      "activeRecallPromptAppend": {
        "type": "string",
        "description": "Optional additional guidance for the active-recall builder."
      },
      "activeRecallMaxSummaryChars": {
        "type": "integer",
        "minimum": 40,
        "maximum": 1000,
        "default": 220,
        "description": "Maximum summary size produced by the active-recall surface."
      },
      "activeRecallRecentUserTurns": {
        "type": "integer",
        "minimum": 0,
        "maximum": 4,
        "default": 2,
        "description": "How many recent user turns to include in the active-recall query context."
      },
      "activeRecallRecentAssistantTurns": {
        "type": "integer",
        "minimum": 0,
        "maximum": 3,
        "default": 1,
        "description": "How many recent assistant turns to include in the active-recall query context."
      },
      "activeRecallRecentUserChars": {
        "type": "integer",
        "minimum": 40,
        "maximum": 1000,
        "default": 600,
        "description": "Per-user-turn character cap for active-recall context assembly."
      },
      "activeRecallRecentAssistantChars": {
        "type": "integer",
        "minimum": 40,
        "maximum": 1000,
        "default": 400,
        "description": "Per-assistant-turn character cap for active-recall context assembly."
      },
      "activeRecallThinking": {
        "type": "string",
        "enum": [
          "off",
          "minimal",
          "low",
          "medium",
          "high",
          "xhigh",
          "adaptive"
        ],
        "default": "low",
        "description": "Reasoning effort used by the active-recall engine."
      },
      "activeRecallTimeoutMs": {
        "type": "integer",
        "minimum": 250,
        "default": 15000,
        "description": "Timeout for an active-recall run."
      },
      "activeRecallCacheTtlMs": {
        "type": "integer",
        "minimum": 0,
        "maximum": 120000,
        "default": 15000,
        "description": "Cache TTL for active-recall summaries; 0 disables the cache."
      },
      "activeRecallModel": {
        "type": "string",
        "description": "Optional model selection for active recall."
      },
      "activeRecallModelFallbackPolicy": {
        "type": "string",
        "enum": [
          "default-remote",
          "resolved-only"
        ],
        "default": "default-remote",
        "description": "How active recall falls back when an explicit model cannot be resolved."
      },
      "activeRecallPersistTranscripts": {
        "type": "boolean",
        "default": false,
        "description": "Persist full active-recall request and response transcripts."
      },
      "activeRecallTranscriptDir": {
        "type": "string",
        "default": "active-recall",
        "description": "Memory-relative directory for active-recall transcripts."
      },
      "activeRecallEntityGraphDepth": {
        "type": "integer",
        "minimum": 0,
        "maximum": 3,
        "default": 1,
        "description": "Entity-graph traversal depth used by active recall."
      },
      "activeRecallIncludeCausalTrajectories": {
        "type": "boolean",
        "default": false,
        "description": "Include causal trajectory recall evidence in active-recall summaries."
      },
      "activeRecallIncludeDaySummary": {
        "type": "boolean",
        "default": false,
        "description": "Include the latest day summary in active-recall context."
      },
      "activeRecallAttachRecallExplain": {
        "type": "boolean",
        "default": false,
        "description": "Attach recall explain output to active-recall diagnostics."
      },
      "activeRecallAllowChainedActiveMemory": {
        "type": "boolean",
        "default": false,
        "description": "Allow active recall to chain into the bundled active-memory surface."
      },
      "codex": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "properties": {
          "installExtension": {
            "type": "boolean",
            "default": true,
            "description": "Install the Remnic Codex memory extension during Codex connector setup."
          },
          "codexHome": {
            "type": [
              "string",
              "null"
            ],
            "default": null,
            "description": "Optional Codex home directory override used for connector install and materialization."
          }
        }
      },
      "connectors": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "description": "Live-connector configuration (issue #683). Each child object maps to one concrete LiveConnector. Defaults are off; operators must opt in.",
        "properties": {
          "googleDrive": {
            "type": "object",
            "additionalProperties": false,
            "default": {},
            "description": "Google Drive live connector (issue #683 PR 2/N). Imports text content from a user's Drive into Remnic on a poll schedule.",
            "properties": {
              "enabled": {
                "type": "boolean",
                "default": false,
                "description": "Master gate. Default off — set to true to enable Drive imports. The connector additionally requires clientId, clientSecret, and refreshToken to be populated before it will run."
              },
              "clientId": {
                "type": "string",
                "default": "",
                "description": "OAuth2 client id. Populate from your secret store (e.g. ${GOOGLE_DRIVE_CLIENT_ID}). Never commit a real value to source."
              },
              "clientSecret": {
                "type": "string",
                "default": "",
                "description": "OAuth2 client secret. Populate from your secret store (e.g. ${GOOGLE_DRIVE_CLIENT_SECRET}). Never commit a real value to source."
              },
              "refreshToken": {
                "type": "string",
                "default": "",
                "description": "OAuth2 refresh token issued for the user's Drive scope. Populate from your secret store (e.g. ${GOOGLE_DRIVE_REFRESH_TOKEN}). Never commit a real value to source."
              },
              "pollIntervalMs": {
                "type": "integer",
                "minimum": 1000,
                "maximum": 86400000,
                "default": 300000,
                "description": "How often the scheduler should call the connector's syncIncremental, in milliseconds. Defaults to 5 minutes; max 24 hours."
              },
              "folderIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [],
                "description": "Optional array of Google Drive folder ids to scope the import. Empty = all accessible files. Folder ids are validated for shape; nested folders are NOT auto-included."
              }
            }
          },
          "notion": {
            "type": "object",
            "additionalProperties": false,
            "default": {},
            "description": "Notion live connector (issue #683 PR 3/N). Imports text content from Notion database pages into Remnic on a poll schedule.",
            "properties": {
              "enabled": {
                "type": "boolean",
                "default": false,
                "description": "Master gate. Default off — set to true to enable Notion imports. The connector additionally requires a token and at least one databaseId to be populated before it will run."
              },
              "token": {
                "type": "string",
                "default": "",
                "description": "Notion integration token (starts with secret_). Populate from your secret store (e.g. ${NOTION_TOKEN}). Never commit a real value to source."
              },
              "databaseIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [],
                "description": "Array of Notion database ids to import pages from. Accepts compact 32-hex-char ids or standard UUID format. Empty = connector is a no-op."
              },
              "pollIntervalMs": {
                "type": "integer",
                "minimum": 1000,
                "maximum": 86400000,
                "default": 300000,
                "description": "How often the scheduler should call the connector's syncIncremental, in milliseconds. Defaults to 5 minutes; max 24 hours."
              }
            }
          },
          "gmail": {
            "type": "object",
            "additionalProperties": false,
            "default": {},
            "description": "Gmail live connector (issue #683 PR 4/6). Imports new inbox messages from Gmail into Remnic on a poll schedule.",
            "properties": {
              "enabled": {
                "type": "boolean",
                "default": false,
                "description": "Master gate. Default off — set to true to enable Gmail imports. The connector additionally requires clientId, clientSecret, and refreshToken to be populated before it will run."
              },
              "clientId": {
                "type": "string",
                "default": "",
                "description": "OAuth2 client id. Populate from your secret store (e.g. ${GMAIL_CLIENT_ID}). Never commit a real value to source."
              },
              "clientSecret": {
                "type": "string",
                "default": "",
                "description": "OAuth2 client secret. Populate from your secret store (e.g. ${GMAIL_CLIENT_SECRET}). Never commit a real value to source."
              },
              "refreshToken": {
                "type": "string",
                "default": "",
                "description": "OAuth2 refresh token issued for the Gmail scope. Populate from your secret store (e.g. ${GMAIL_REFRESH_TOKEN}). Never commit a real value to source."
              },
              "userId": {
                "type": "string",
                "default": "me",
                "description": "Gmail userId. Defaults to 'me' (the authenticated user). Override only in delegated-access scenarios."
              },
              "query": {
                "type": "string",
                "default": "in:inbox",
                "description": "Gmail search query applied in addition to the watermark after: filter. Default 'in:inbox'. Set to '' to import all mail."
              },
              "pollIntervalMs": {
                "type": "integer",
                "minimum": 1000,
                "maximum": 86400000,
                "default": 300000,
                "description": "How often the scheduler should call the connector's syncIncremental, in milliseconds. Defaults to 5 minutes; max 24 hours."
              }
            }
          },
          "github": {
            "type": "object",
            "additionalProperties": false,
            "default": {},
            "description": "GitHub live connector (issue #683 PR 5/6). Imports issue comments, PR review comments, and optionally discussion posts authored by the configured user from watched repos into Remnic on a poll schedule.",
            "properties": {
              "enabled": {
                "type": "boolean",
                "default": false,
                "description": "Master gate. Default off — set to true to enable GitHub imports. The connector additionally requires token, userLogin, and at least one repo to be populated before it will run."
              },
              "token": {
                "type": "string",
                "default": "",
                "description": "GitHub personal access token. Populate from your secret store (e.g. ${GITHUB_TOKEN}). Never commit a real value to source."
              },
              "userLogin": {
                "type": "string",
                "default": "",
                "description": "GitHub login of the user whose comments will be imported. Only comments authored by this login are ingested. Required when enabled."
              },
              "repos": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [],
                "description": "Array of repos to poll in \"owner/repo\" format. Empty = connector is a no-op."
              },
              "pollIntervalMs": {
                "type": "integer",
                "minimum": 1000,
                "maximum": 86400000,
                "default": 300000,
                "description": "How often the scheduler should call the connector's syncIncremental, in milliseconds. Defaults to 5 minutes; max 24 hours."
              },
              "includeDiscussions": {
                "type": "boolean",
                "default": false,
                "description": "Whether to import GitHub Discussion comments in addition to issue and PR review comments. Default false."
              }
            }
          }
        }
      },
      "codexMaterializeMemories": {
        "type": "boolean",
        "default": true,
        "description": "Enable Codex native memory materialization into the Codex memories directory."
      },
      "codexMaterializeNamespace": {
        "type": "string",
        "default": "auto",
        "description": "Namespace to materialize for Codex. \"auto\" derives the namespace from the active connector context."
      },
      "codexMaterializeMaxSummaryTokens": {
        "type": "number",
        "minimum": 0,
        "default": 4500,
        "description": "Whitespace-token cap for Codex memory summary materialization."
      },
      "codexMaterializeRolloutRetentionDays": {
        "type": "number",
        "minimum": 0,
        "default": 30,
        "description": "Retention window in days for Codex rollout materialization artifacts."
      },
      "codexMaterializeOnConsolidation": {
        "type": "boolean",
        "default": true,
        "description": "Run Codex memory materialization after semantic or causal consolidation completes."
      },
      "codexMaterializeOnSessionEnd": {
        "type": "boolean",
        "default": true,
        "description": "Run Codex memory materialization from the Codex session-end hook."
      },
      "codexMarketplaceEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable Codex marketplace integration for plugin discovery and installation."
      },
      "versioningEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable page-level versioning with sidecar snapshots."
      },
      "versioningMaxPerPage": {
        "type": "integer",
        "default": 50,
        "minimum": 0,
        "description": "Maximum number of version snapshots per page. Set to 0 to disable pruning."
      },
      "versioningSidecarDir": {
        "type": "string",
        "default": ".versions",
        "description": "Name of the sidecar directory inside memoryDir for version snapshots."
      },
      "taxonomyEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable the MECE taxonomy knowledge directory for categorizing memories."
      },
      "taxonomyAutoGenResolver": {
        "type": "boolean",
        "default": true,
        "description": "Auto-regenerate RESOLVER.md when the taxonomy changes."
      },
      "emitLegacyTools": {
        "type": "boolean",
        "default": true,
        "description": "Advertise legacy engram_* / engram.* MCP tool aliases alongside the canonical remnic_* names (issue #1427). Default true for backward compatibility. Set false to halve the advertised tools/list surface (only remnic_* names); tools remain callable under both names. Also settable via REMNIC_EMIT_LEGACY_TOOLS."
      },
      "citationsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable oai-mem-citation blocks in recall responses for Codex citation parity."
      },
      "citationsAutoDetect": {
        "type": "boolean",
        "default": true,
        "description": "Auto-enable citations when the Codex adapter is detected."
      },
      "memoryExtensionsEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Whether third-party memory extensions are discovered and included in consolidation instructions."
      },
      "memoryExtensionsRoot": {
        "type": "string",
        "default": "",
        "description": "Root directory for memory extensions. Empty string derives from memoryDir (go up to Remnic home and append memory_extensions)."
      },
      "binaryLifecycleEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable binary file lifecycle management. When true, binary files in the memory directory are mirrored, redirected, and cleaned."
      },
      "binaryLifecycleGracePeriodDays": {
        "type": "number",
        "default": 7,
        "minimum": 0,
        "description": "Days to wait before cleaning local copies of mirrored binary files."
      },
      "binaryLifecycleBackendType": {
        "type": "string",
        "enum": [
          "none",
          "filesystem",
          "s3"
        ],
        "default": "none",
        "description": "Storage backend for binary lifecycle mirror stage."
      },
      "binaryLifecycleBackendPath": {
        "type": "string",
        "default": "",
        "description": "Base path for the filesystem storage backend."
      },
      "codexCompat": {
        "type": "object",
        "additionalProperties": false,
        "default": {},
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false
          },
          "threadIdBufferKeying": {
            "type": "boolean",
            "default": true
          },
          "compactionFlushMode": {
            "type": "string",
            "enum": [
              "signal",
              "heuristic",
              "auto"
            ],
            "default": "auto"
          },
          "fingerprintDedup": {
            "type": "boolean",
            "default": true
          }
        }
      },
      "debug": {
        "type": "boolean",
        "default": false,
        "description": "Enable debug logging"
      },
      "identityEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable agent identity reflections (appends to workspace IDENTITY.md)"
      },
      "identityContinuityEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable identity continuity workflows (anchor, incidents, audits)"
      },
      "identityInjectionMode": {
        "type": "string",
        "enum": [
          "recovery_only",
          "minimal",
          "full"
        ],
        "default": "recovery_only",
        "description": "Controls when identity continuity context is added to recall assembly"
      },
      "identityMaxInjectChars": {
        "type": "number",
        "default": 1200,
        "description": "Maximum characters allowed for identity continuity context"
      },
      "continuityIncidentLoggingEnabled": {
        "type": "boolean",
        "description": "When unset, defaults to identityContinuityEnabled. Controls continuity incident logging artifacts."
      },
      "continuityAuditEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable continuity audit artifact generation workflows"
      },
      "sessionObserverEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable heartbeat-driven active session observer checks for proactive extraction triggers."
      },
      "sessionObserverDebounceMs": {
        "type": "number",
        "default": 120000,
        "description": "Minimum interval between heartbeat observer triggers per session (ms)."
      },
      "sessionObserverBands": {
        "type": "array",
        "description": "Session size bands and growth thresholds for heartbeat observer triggers.",
        "items": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "maxBytes": {
              "type": "number"
            },
            "triggerDeltaBytes": {
              "type": "number"
            },
            "triggerDeltaTokens": {
              "type": "number"
            }
          },
          "required": [
            "maxBytes",
            "triggerDeltaBytes",
            "triggerDeltaTokens"
          ]
        },
        "default": [
          {
            "maxBytes": 50000,
            "triggerDeltaBytes": 4800,
            "triggerDeltaTokens": 1200
          },
          {
            "maxBytes": 200000,
            "triggerDeltaBytes": 9600,
            "triggerDeltaTokens": 2400
          },
          {
            "maxBytes": 1000000000,
            "triggerDeltaBytes": 19200,
            "triggerDeltaTokens": 4800
          }
        ]
      },
      "injectQuestions": {
        "type": "boolean",
        "default": false,
        "description": "Include the most relevant open question in generated memory context"
      },
      "commitmentDecayDays": {
        "type": "integer",
        "minimum": 1,
        "default": 90,
        "description": "Days before fulfilled/expired commitments are removed"
      },
      "workspaceDir": {
        "type": "string",
        "description": "Override workspace directory path"
      },
      "fileHygiene": {
        "type": "object",
        "additionalProperties": false,
        "description": "Optional: keep OpenClaw bootstrap workspace files small and warn before silent truncation risk.",
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false,
            "description": "Master switch for file hygiene (default off)."
          },
          "lintEnabled": {
            "type": "boolean",
            "default": true,
            "description": "If true, warn when bootstrap files approach budget."
          },
          "lintBudgetBytes": {
            "type": "number",
            "default": 20000,
            "description": "Budget in bytes used for lint warnings (approx)."
          },
          "lintWarnRatio": {
            "type": "number",
            "default": 0.8,
            "description": "Warn when file size >= budget * warnRatio."
          },
          "lintPaths": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [
              "IDENTITY.md",
              "MEMORY.md"
            ],
            "description": "Workspace-relative paths to lint (or absolute paths)."
          },
          "rotateEnabled": {
            "type": "boolean",
            "default": false,
            "description": "If true, rotate oversized markdown files into an archive and replace with a lean index."
          },
          "rotateMaxBytes": {
            "type": "number",
            "default": 18000,
            "description": "Rotate when a target file exceeds this size (bytes)."
          },
          "rotateKeepTailChars": {
            "type": "number",
            "default": 2000,
            "description": "How many characters of the old file to keep inline (tail) for continuity."
          },
          "rotatePaths": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [
              "IDENTITY.md"
            ],
            "description": "Workspace-relative paths to rotate (or absolute paths)."
          },
          "archiveDir": {
            "type": "string",
            "default": ".engram-archive",
            "description": "Workspace-relative archive directory where rotated files are stored."
          },
          "runMinIntervalMs": {
            "type": "number",
            "default": 300000,
            "description": "Minimum interval between hygiene runs (ms)."
          },
          "warningsLogEnabled": {
            "type": "boolean",
            "default": false,
            "description": "If true, append warnings to a log file under memoryDir."
          },
          "warningsLogPath": {
            "type": "string",
            "default": "hygiene/warnings.md",
            "description": "memoryDir-relative path to write warnings to."
          },
          "indexEnabled": {
            "type": "boolean",
            "default": false,
            "description": "Reserved: write an Engram index file in workspace (not required for rotation)."
          },
          "indexPath": {
            "type": "string",
            "default": "ENGRAM_INDEX.md",
            "description": "Workspace-relative index path (if indexEnabled)."
          }
        },
        "required": [
          "enabled"
        ]
      },
      "nativeKnowledge": {
        "type": "object",
        "additionalProperties": false,
        "description": "Optional: search curated workspace markdown files directly during recall without converting them into durable memory files.",
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false,
            "description": "Master switch for curated workspace file recall."
          },
          "includeFiles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [
              "IDENTITY.md",
              "MEMORY.md"
            ],
            "description": "Workspace-relative curated markdown files to scan for native knowledge recall."
          },
          "maxChunkChars": {
            "type": "number",
            "default": 900,
            "description": "Maximum chunk size per native knowledge section before it is split."
          },
          "maxResults": {
            "type": "number",
            "default": 4,
            "description": "Maximum native knowledge chunks to add to recall."
          },
          "maxChars": {
            "type": "number",
            "default": 2400,
            "description": "Maximum total characters to add from native knowledge recall."
          },
          "stateDir": {
            "type": "string",
            "default": "state/native-knowledge",
            "description": "Memory-relative directory used for backend-agnostic native knowledge sync state."
          },
          "openclawWorkspace": {
            "type": "object",
            "additionalProperties": false,
            "description": "Optional adapter for OpenClaw workspace artifacts such as bootstrap docs, handoffs, daily summaries, and automation notes.",
            "properties": {
              "enabled": {
                "type": "boolean",
                "default": false,
                "description": "Enable the OpenClaw workspace native-knowledge adapter."
              },
              "bootstrapFiles": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [
                  "IDENTITY.md",
                  "MEMORY.md",
                  "USER.md"
                ],
                "description": "Workspace-relative bootstrap docs treated as high-confidence native knowledge."
              },
              "handoffGlobs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [
                  "**/*handoff*.md",
                  "handoffs/**/*.md"
                ],
                "description": "Glob patterns (relative to workspaceDir) used to discover handoff notes."
              },
              "dailySummaryGlobs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [
                  "**/*daily*summary*.md",
                  "summaries/**/*.md"
                ],
                "description": "Glob patterns (relative to workspaceDir) used to discover daily summary notes."
              },
              "automationNoteGlobs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [],
                "description": "Optional glob patterns for automation-written status or operating notes."
              },
              "workspaceDocGlobs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [],
                "description": "Optional glob patterns for other explicitly allowlisted workspace docs."
              },
              "excludeGlobs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [],
                "description": "Additional glob patterns appended to the built-in workspace safety excludes."
              },
              "sharedSafeGlobs": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "default": [],
                "description": "Optional glob patterns that should be tagged as shared-safe when no explicit privacy class is present."
              }
            },
            "required": [
              "enabled"
            ]
          },
          "obsidianVaults": {
            "type": "array",
            "default": [],
            "description": "Optional Obsidian vault adapters to sync into backend-agnostic native knowledge records.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Stable vault identifier used in synced note metadata."
                },
                "rootDir": {
                  "type": "string",
                  "description": "Absolute path to the Obsidian vault root."
                },
                "includeGlobs": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "default": [
                    "**/*.md"
                  ],
                  "description": "Glob patterns (relative to the vault root) that are eligible for sync."
                },
                "excludeGlobs": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "default": [
                    ".obsidian/**",
                    "**/*.canvas",
                    "**/*.png",
                    "**/*.jpg",
                    "**/*.jpeg",
                    "**/*.gif",
                    "**/*.pdf"
                  ],
                  "description": "Glob patterns excluded from sync."
                },
                "namespace": {
                  "type": "string",
                  "description": "Default namespace assigned to records from this vault."
                },
                "privacyClass": {
                  "type": "string",
                  "description": "Operator-defined privacy class preserved on synced records."
                },
                "folderRules": {
                  "type": "array",
                  "default": [],
                  "description": "Optional per-folder overrides for namespace or privacy classification.",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "pathPrefix": {
                        "type": "string",
                        "description": "Vault-relative folder prefix that activates the override."
                      },
                      "namespace": {
                        "type": "string",
                        "description": "Namespace override for matching notes."
                      },
                      "privacyClass": {
                        "type": "string",
                        "description": "Privacy-class override for matching notes."
                      }
                    },
                    "required": [
                      "pathPrefix"
                    ]
                  }
                },
                "dailyNotePatterns": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "default": [
                    "YYYY-MM-DD"
                  ],
                  "description": "Filename patterns used to derive daily-note dates (for example `YYYY-MM-DD` or `YYYY/MM/DD`)."
                },
                "materializeBacklinks": {
                  "type": "boolean",
                  "default": false,
                  "description": "If true, compute backlinks from wikilink targets for recall hints and explainability."
                }
              },
              "required": [
                "rootDir"
              ]
            }
          }
        },
        "required": [
          "enabled"
        ]
      },
      "agentAccessHttp": {
        "type": "object",
        "additionalProperties": false,
        "description": "Optional: run a local authenticated HTTP API so non-OpenClaw clients can query Engram directly.",
        "properties": {
          "enabled": {
            "type": "boolean",
            "default": false,
            "description": "Start the local Engram HTTP access server during plugin startup."
          },
          "host": {
            "type": "string",
            "default": "127.0.0.1",
            "description": "Loopback host to bind for the Engram HTTP access server."
          },
          "port": {
            "type": "number",
            "default": 4318,
            "description": "Bind port for the Engram HTTP access server. Use 0 for an ephemeral port."
          },
          "authToken": {
            "description": "Bearer token for the local Remnic HTTP API. Either a literal string (supports ${ENV_VAR} expansion) or an OpenClaw SecretRef object (e.g. {\"source\":\"exec\",\"provider\":\"kc_openclaw_remnic_token\",\"id\":\"value\"}) resolved at startup via the OpenClaw gateway secret resolver (issue #757). If omitted, OPENCLAW_REMNIC_ACCESS_TOKEN / OPENCLAW_ENGRAM_ACCESS_TOKEN is used.",
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "required": [
                  "source"
                ],
                "properties": {
                  "source": {
                    "type": "string",
                    "minLength": 1
                  },
                  "provider": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "command": {}
                }
              }
            ]
          },
          "principal": {
            "type": "string",
            "description": "Optional trusted principal bound to the local Engram access bridge. When set, namespace write authorization is evaluated against this principal instead of any client-supplied sessionKey. If omitted, OPENCLAW_ENGRAM_ACCESS_PRINCIPAL is used when present."
          },
          "maxBodyBytes": {
            "type": "number",
            "default": 131072,
            "description": "Maximum accepted JSON request body size for the local Remnic HTTP API."
          }
        },
        "required": [
          "enabled"
        ]
      },
      "accessTrackingEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Track memory access counts and recency"
      },
      "accessTrackingBufferMaxSize": {
        "type": "number",
        "default": 100,
        "description": "Max entries in access tracking buffer before flush"
      },
      "recencyWeight": {
        "type": "number",
        "default": 0.2,
        "description": "Weight for recency boosting in search (0-1)"
      },
      "boostAccessCount": {
        "type": "boolean",
        "default": true,
        "description": "Boost frequently accessed memories in search results"
      },
      "recordEmptyRecallImpressions": {
        "type": "boolean",
        "default": false,
        "description": "Record recall impressions with empty memoryIds when no memory context is added."
      },
      "recallPlannerEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Use lightweight retrieve-vs-think planning to avoid unnecessary recall work."
      },
      "recallPlannerLlmEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Opt in to LLM-based recall planning (issue #1367). When false, recall mode is decided by the regex heuristic. When true, the configured recallPlannerModel classifies recall intent via the gateway/fallback LLM chain (provider-agnostic) and falls back to the heuristic on timeout/error. Requires recallPlannerEnabled."
      },
      "recallPlannerModel": {
        "type": "string",
        "default": "gpt-5.5",
        "description": "Model for LLM-based recall planning (recallPlannerLlmEnabled). A 'provider/model' string resolved through the gateway providers/chain — any configured provider works (OpenAI, Anthropic, Ollama, Codex, gateway personas). Tried first, with taskModelChain / gateway defaults as fallback."
      },
      "recallPlannerTimeoutMs": {
        "type": "number",
        "default": 1500,
        "description": "Timeout in ms for recall planner inference."
      },
      "recallPlannerUseResponsesApi": {
        "type": "boolean",
        "default": true,
        "description": "Reserved. The chat vs Responses API dialect is chosen per-provider by the gateway/fallback client based on each provider's api field, so this flag does not override routing; OpenAI providers already use Responses (gotcha #1)."
      },
      "recallPlannerMaxPromptChars": {
        "type": "number",
        "default": 4000,
        "description": "Maximum characters of prompt context to send to the recall planner."
      },
      "recallPlannerMaxMemoryHints": {
        "type": "number",
        "default": 24,
        "description": "Reserved. Caps recent-memory hints in the recall planner prompt when a caller supplies them; the default recall path does not populate hints (the LLM planner classifies on the prompt alone)."
      },
      "recallPlannerShadowMode": {
        "type": "boolean",
        "default": false,
        "description": "Run recall planner in shadow mode — evaluate but do not apply results."
      },
      "recallPlannerTelemetryEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Emit telemetry events for recall planner decisions."
      },
      "recallPlannerMaxQmdResultsMinimal": {
        "type": "number",
        "default": 4,
        "description": "QMD cap used when recall planner selects minimal mode."
      },
      "recallPlannerMaxQmdResultsFull": {
        "type": "number",
        "default": 8,
        "description": "QMD cap used when recall planner selects full mode."
      },
      "intentRoutingEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Attach intent metadata to memories and boost compatible memories at recall."
      },
      "intentRoutingBoost": {
        "type": "number",
        "default": 0.12,
        "description": "Maximum score boost applied for intent-compatible memory matches."
      },
      "verbatimArtifactsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Write quote-first artifact anchors during extraction and include them in recall."
      },
      "verbatimArtifactsMinConfidence": {
        "type": "number",
        "default": 0.8,
        "description": "Minimum extraction confidence required before writing an artifact."
      },
      "verbatimArtifactsMaxRecall": {
        "type": "number",
        "default": 5,
        "description": "Maximum artifact anchors added per recall."
      },
      "verbatimArtifactCategories": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "fact",
            "preference",
            "correction",
            "entity",
            "decision",
            "relationship",
            "principle",
            "commitment",
            "moment",
            "skill",
            "procedure"
          ]
        },
        "default": [
          "decision",
          "correction",
          "principle",
          "commitment"
        ],
        "description": "Memory categories eligible for artifact extraction."
      },
      "memoryBoxesEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Memory Boxes (v8.0 Phase 2A). Groups memories into topic-bounded windows. Disabled by default."
      },
      "boxTopicShiftThreshold": {
        "type": "number",
        "default": 0.35,
        "description": "Jaccard overlap threshold below which a topic shift seals the current box (0–1)."
      },
      "boxTimeGapMs": {
        "type": "number",
        "default": 1800000,
        "description": "Time gap in milliseconds before an open box is sealed (default 30 min)."
      },
      "boxMaxMemories": {
        "type": "number",
        "default": 50,
        "description": "Maximum memories per box before forced seal."
      },
      "traceWeaverEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Trace Weaving (v8.0 Phase 2A). Links recurring topic boxes with a shared traceId."
      },
      "traceWeaverLookbackDays": {
        "type": "number",
        "default": 7,
        "description": "Days back to search for trace links."
      },
      "traceWeaverOverlapThreshold": {
        "type": "number",
        "default": 0.4,
        "description": "Minimum Jaccard topic overlap to assign the same traceId (0–1)."
      },
      "boxRecallDays": {
        "type": "number",
        "default": 3,
        "description": "Number of recent days of boxes to add during recall."
      },
      "episodeNoteModeEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable HiMem episode/note classification (v8.0 Phase 2B). Tags each extracted memory as 'episode' (time-specific event) or 'note' (stable belief/preference). Disabled by default."
      },
      "queryAwareIndexingEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable temporal and tag indexes (v8.1). Maintains state/index_time.json and state/index_tags.json for fast prefiltering. At recall time, temporal queries and #tag tokens receive a small score boost from the index. Disabled by default."
      },
      "queryAwareIndexingMaxCandidates": {
        "type": "number",
        "default": 200,
        "description": "Max candidate paths returned from index prefilter before scoring (0 = no cap)."
      },
      "temporalIndexWindowDays": {
        "type": "number",
        "default": 30,
        "description": "Number of days to include in the temporal index window."
      },
      "temporalIndexMaxEntries": {
        "type": "number",
        "default": 5000,
        "description": "Maximum number of entries in the temporal index."
      },
      "temporalBoostRecentDays": {
        "type": "number",
        "default": 7,
        "description": "Memories from the last N days receive a recency boost during recall."
      },
      "temporalBoostScore": {
        "type": "number",
        "default": 0.15,
        "description": "Score boost applied to recent memories during recall."
      },
      "temporalDecayEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Apply temporal decay to older memories during recall scoring."
      },
      "tagMemoryEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable tag-based memory indexing and recall boosting."
      },
      "tagMaxPerMemory": {
        "type": "number",
        "default": 5,
        "description": "Maximum number of tags assigned per memory."
      },
      "tagIndexMaxEntries": {
        "type": "number",
        "default": 10000,
        "description": "Maximum number of entries in the tag index."
      },
      "tagRecallBoost": {
        "type": "number",
        "default": 0.15,
        "description": "Score boost applied to memories whose tags match the query."
      },
      "tagRecallMaxMatches": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of tag-matched memories added per recall."
      },
      "multiGraphMemoryEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable multi-graph memory (entity, time, causal edges). Default false."
      },
      "graphRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable graph recall planner mode (`graph_mode`). Requires multiGraphMemoryEnabled. Default false."
      },
      "graphRecallMaxExpansions": {
        "type": "number",
        "default": 3,
        "description": "Maximum number of expansion hops per graph recall query."
      },
      "graphRecallMaxPerSeed": {
        "type": "number",
        "default": 5,
        "description": "Maximum graph-expanded results per seed node."
      },
      "graphRecallMinEdgeWeight": {
        "type": "number",
        "default": 0.1,
        "description": "Minimum edge weight to follow during graph recall traversal."
      },
      "graphRecallShadowEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Run graph recall in shadow mode - evaluate but do not add results."
      },
      "graphRecallSnapshotEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Write graph recall snapshots for offline analysis."
      },
      "graphRecallShadowSampleRate": {
        "type": "number",
        "default": 0.1,
        "description": "Fraction of turns evaluated in shadow mode (0-1)."
      },
      "graphRecallExplainToolEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Expose a graph explain tool to agents during graph recall."
      },
      "graphRecallStoreColdMirror": {
        "type": "boolean",
        "default": false,
        "description": "Store cold-path graph recall results in a secondary QMD collection."
      },
      "graphRecallColdMirrorCollection": {
        "type": "string",
        "description": "QMD collection name for cold-mirror graph recall results."
      },
      "graphRecallColdMirrorMinAgeDays": {
        "type": "number",
        "default": 7,
        "description": "Minimum age in days for a memory to qualify for cold-mirror storage."
      },
      "graphRecallUseEntityPriors": {
        "type": "boolean",
        "default": false,
        "description": "Boost seed nodes using entity prior scores during graph recall."
      },
      "graphRecallEntityPriorBoost": {
        "type": "number",
        "default": 0.2,
        "description": "Score boost applied to nodes with strong entity priors."
      },
      "graphRecallPreferHubSeeds": {
        "type": "boolean",
        "default": false,
        "description": "Prefer high-degree hub nodes as graph recall seeds."
      },
      "graphRecallHubBias": {
        "type": "number",
        "default": 0.3,
        "description": "Bias weight toward hub-seed selection (0-1)."
      },
      "graphRecallRecencyHalfLifeDays": {
        "type": "number",
        "default": 30,
        "description": "Half-life in days for recency decay applied to graph-expanded nodes."
      },
      "graphRecallDampingFactor": {
        "type": "number",
        "default": 0.85,
        "description": "PageRank-style damping factor for graph activation propagation."
      },
      "graphRecallMaxSeedNodes": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of seed nodes selected for graph recall expansion."
      },
      "graphRecallMaxExpandedNodes": {
        "type": "number",
        "default": 30,
        "description": "Maximum total nodes visited during graph recall expansion."
      },
      "graphRecallMaxTrailPerNode": {
        "type": "number",
        "default": 5,
        "description": "Maximum trail length followed per node during graph traversal."
      },
      "graphRecallMinSeedScore": {
        "type": "number",
        "default": 0.3,
        "description": "Minimum QMD score for a memory to qualify as a graph recall seed."
      },
      "graphRecallExpansionScoreThreshold": {
        "type": "number",
        "default": 0.2,
        "description": "Minimum blended score required to include a graph-expanded node in results."
      },
      "graphRecallExplainMaxPaths": {
        "type": "number",
        "default": 3,
        "description": "Maximum reasoning paths included in a graph recall explanation."
      },
      "graphRecallExplainMaxChars": {
        "type": "number",
        "default": 500,
        "description": "Maximum characters per graph recall explanation."
      },
      "graphRecallExplainEdgeLimit": {
        "type": "number",
        "default": 5,
        "description": "Maximum edges described per node in a graph recall explanation."
      },
      "graphRecallExplainEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Append natural-language graph reasoning explanations to recall output."
      },
      "graphRecallEntityHintsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Inject entity hint summaries alongside graph-recalled memories."
      },
      "graphRecallEntityHintMax": {
        "type": "number",
        "default": 3,
        "description": "Maximum number of entity hints added per graph recall result."
      },
      "graphRecallEntityHintMaxChars": {
        "type": "number",
        "default": 200,
        "description": "Maximum characters per entity hint added during graph recall."
      },
      "graphRecallSnapshotDir": {
        "type": "string",
        "description": "Directory for graph recall snapshot files (defaults to {memoryDir}/state/graph)."
      },
      "graphRecallEnableTrace": {
        "type": "boolean",
        "default": false,
        "description": "Enable detailed graph recall trace logging for debugging."
      },
      "graphRecallEnableDebug": {
        "type": "boolean",
        "default": false,
        "description": "Enable verbose debug output for graph recall operations."
      },
      "graphExpandedIntentEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Escalate broader causal/timeline phrasing into graph_mode planning."
      },
      "graphAssistInFullModeEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Run bounded graph expansion during full recall mode when seed results exist."
      },
      "graphAssistShadowEvalEnabled": {
        "type": "boolean",
        "default": false,
        "description": "In full mode, compute graph assist for comparison telemetry and snapshots but keep recall output baseline-identical."
      },
      "graphAssistMinSeedResults": {
        "type": "number",
        "default": 3,
        "description": "Minimum seed recall results required before full-mode graph assist runs."
      },
      "entityGraphEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Build entity co-reference graph (requires multiGraphMemoryEnabled). Default true."
      },
      "timeGraphEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Build temporal sequence graph within threads (requires multiGraphMemoryEnabled). Default true."
      },
      "graphWriteSessionAdjacencyEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Write fallback temporal adjacency edges for consecutive extracted memories in the same session."
      },
      "causalGraphEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Build causal inference graph from heuristic phrases (requires multiGraphMemoryEnabled). Default true."
      },
      "maxGraphTraversalSteps": {
        "type": "number",
        "default": 3,
        "description": "Maximum BFS hops during spreading activation. Default 3."
      },
      "graphActivationDecay": {
        "type": "number",
        "default": 0.7,
        "description": "Per-hop activation decay factor (0-1). Default 0.7."
      },
      "graphTraversalConfidenceFloor": {
        "type": "number",
        "default": 0.2,
        "minimum": 0,
        "maximum": 1,
        "description": "Issue #681 PR 3/3: minimum edge confidence required for traversal during spreading activation. Edges below this floor are pruned and contribute neither activation nor downstream neighbors. Legacy edges without a confidence field are treated as 1.0. Range 0-1. Default 0.2."
      },
      "graphTraversalPageRankIterations": {
        "type": "number",
        "default": 8,
        "minimum": 0,
        "description": "Issue #681 PR 3/3: number of PageRank-style refinement iterations applied on top of the BFS spreading-activation scores. Each iteration redistributes a node's confidence-weighted activation along its outgoing edges. Set to 0 to disable refinement and use raw BFS scores. Default 8."
      },
      "graphExpansionActivationWeight": {
        "type": "number",
        "default": 0.65,
        "description": "Blend weight for graph activation when scoring expanded results (0-1). Higher values favor graph activation over seed QMD score."
      },
      "graphExpansionBlendMin": {
        "type": "number",
        "default": 0.05,
        "description": "Lower clamp bound for blended graph-expanded recall scores (0-1)."
      },
      "graphExpansionBlendMax": {
        "type": "number",
        "default": 0.95,
        "description": "Upper clamp bound for blended graph-expanded recall scores (0-1)."
      },
      "maxEntityGraphEdgesPerMemory": {
        "type": "number",
        "default": 10,
        "description": "Maximum entity graph edges written per memory write. Default 10."
      },
      "delinearizeEnabled": {
        "type": "boolean",
        "default": true,
        "description": "SimpleMem-inspired de-linearization: resolve pronouns and anchor relative dates in extracted memories"
      },
      "recallConfidenceGateEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Synapse-inspired confidence gate: skip memory context when top recall score is below threshold"
      },
      "recallConfidenceGateThreshold": {
        "type": "number",
        "default": 0.12,
        "description": "Minimum top recall score to include memories (0-1). Below this, memories are rejected as too uncertain"
      },
      "causalRuleExtractionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "PlugMem-inspired causal rule extraction: mine IF-THEN rules from conversations during consolidation"
      },
      "memoryReconstructionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "E-Mem-inspired memory reconstruction: targeted secondary retrieval for entity references lacking context in recall"
      },
      "memoryReconstructionMaxExpansions": {
        "type": "number",
        "default": 3,
        "description": "Maximum number of entity expansions per recall cycle"
      },
      "graphLateralInhibitionEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Synapse-inspired lateral inhibition to suppress hub-node dominance in graph retrieval"
      },
      "graphLateralInhibitionBeta": {
        "type": "number",
        "default": 0.15,
        "description": "Inhibition strength (0-1). Higher values suppress weaker nodes more aggressively"
      },
      "graphLateralInhibitionTopM": {
        "type": "number",
        "default": 7,
        "description": "Number of top competing nodes considered for lateral inhibition"
      },
      "graphEdgeDecayEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable the periodic graph-edge confidence decay maintenance job (issue #681 PR 2/3). Opt-in."
      },
      "graphEdgeDecayCadenceMs": {
        "type": "number",
        "default": 604800000,
        "minimum": 60000,
        "description": "Cadence in milliseconds for the graph-edge decay cron. Default 7 days. Sub-day cadences map to a daily cron expression."
      },
      "graphEdgeDecayWindowMs": {
        "type": "number",
        "default": 7776000000,
        "minimum": 60000,
        "description": "Decay window in milliseconds passed to decayEdgeConfidence. Default 90 days."
      },
      "graphEdgeDecayPerWindow": {
        "type": "number",
        "default": 0.1,
        "minimum": 0,
        "maximum": 1,
        "description": "Per-window confidence drop applied during decay. Default 0.1."
      },
      "graphEdgeDecayFloor": {
        "type": "number",
        "default": 0.1,
        "minimum": 0,
        "maximum": 1,
        "description": "Floor confidence will not decay below. Default 0.1."
      },
      "graphEdgeDecayVisibilityThreshold": {
        "type": "number",
        "default": 0.2,
        "minimum": 0,
        "maximum": 1,
        "description": "Confidence threshold used by the decay telemetry counter for low-visibility edges. Default 0.2."
      },
      "temporalMemoryTreeEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Build a hierarchical memory summary tree (hour/day/week/persona nodes). Default: false."
      },
      "tmtHourlyMinMemories": {
        "type": "number",
        "default": 3,
        "description": "Minimum new memories in an hour to trigger an hour-level TMT node. Default: 3."
      },
      "tmtSummaryMaxTokens": {
        "type": "number",
        "default": 300,
        "description": "Max tokens for each TMT summary node. Default: 300."
      },
      "explicitCueRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Front-load exact LCM evidence for query-visible cues such as turns, dates, ids, files, and tools."
      },
      "explicitCueRecallMaxChars": {
        "type": "number",
        "default": 2400,
        "minimum": 0,
        "description": "Character budget for the explicit cue evidence recall section."
      },
      "explicitCueRecallMaxReferences": {
        "type": "number",
        "default": 24,
        "minimum": 0,
        "description": "Maximum query-visible cues expanded by explicit cue recall."
      },
      "targetedFactRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable targeted fact evidence recall for direct answer questions."
      },
      "targetedFactRecallMaxChars": {
        "type": "integer",
        "default": 2400,
        "minimum": 0,
        "description": "Character budget for the targeted fact evidence recall section."
      },
      "targetedFactRecallMaxResults": {
        "type": "integer",
        "default": 48,
        "minimum": 0,
        "description": "Maximum recalled items for targeted fact evidence."
      },
      "targetedFactRecallScanWindowTurns": {
        "type": "integer",
        "default": 8,
        "minimum": 1,
        "description": "Recent-turn scan window for targeted fact evidence."
      },
      "targetedFactRecallScanWindowTokens": {
        "type": "integer",
        "default": 12000,
        "minimum": 1,
        "description": "Recent-token scan window for targeted fact evidence."
      },
      "focusedListRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable focused list evidence recall for count, relation, and recommendation questions."
      },
      "focusedListRecallMaxChars": {
        "type": "integer",
        "default": 2600,
        "minimum": 0,
        "description": "Character budget for the focused list evidence recall section."
      },
      "focusedListRecallMaxResults": {
        "type": "integer",
        "default": 40,
        "minimum": 0,
        "description": "Maximum recalled items for focused list evidence."
      },
      "focusedListRecallScanWindowTurns": {
        "type": "integer",
        "default": 64,
        "minimum": 1,
        "description": "Recent-turn scan window for focused list evidence."
      },
      "focusedListRecallScanWindowTokens": {
        "type": "integer",
        "default": 14000,
        "minimum": 1,
        "description": "Recent-token scan window for focused list evidence."
      },
      "responseGuidanceRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable response guidance recall for user answer-shape preferences."
      },
      "responseGuidanceRecallMaxChars": {
        "type": "integer",
        "default": 2400,
        "minimum": 0,
        "description": "Character budget for the response guidance recall section."
      },
      "responseGuidanceRecallMaxResults": {
        "type": "integer",
        "default": 48,
        "minimum": 0,
        "description": "Maximum recalled items for response guidance."
      },
      "responseGuidanceRecallScanWindowTurns": {
        "type": "integer",
        "default": 64,
        "minimum": 1,
        "description": "Recent-turn scan window for response guidance."
      },
      "responseGuidanceRecallScanWindowTokens": {
        "type": "integer",
        "default": 16000,
        "minimum": 1,
        "description": "Recent-token scan window for response guidance."
      },
      "eventOrderRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable event-order evidence recall for chronology questions."
      },
      "eventOrderRecallMaxChars": {
        "type": "integer",
        "default": 2400,
        "minimum": 0,
        "description": "Character budget for the event-order evidence recall section."
      },
      "eventOrderRecallMaxResults": {
        "type": "integer",
        "default": 24,
        "minimum": 0,
        "description": "Maximum recalled items for event-order evidence."
      },
      "eventOrderRecallScanWindowTurns": {
        "type": "integer",
        "default": 12,
        "minimum": 1,
        "description": "Recent-turn scan window for event-order evidence."
      },
      "eventOrderRecallScanWindowTokens": {
        "type": "integer",
        "default": 24000,
        "minimum": 1,
        "description": "Recent-token scan window for event-order evidence."
      },
      "queryExpansionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable heuristic query expansion for retrieval (no LLM calls)."
      },
      "queryExpansionMaxQueries": {
        "type": "number",
        "default": 4,
        "description": "Max expanded queries to run (including the original prompt)."
      },
      "queryExpansionMinTokenLen": {
        "type": "number",
        "default": 3,
        "description": "Minimum token length to include in heuristic query expansion."
      },
      "rerankEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable LLM re-ranking of retrieved memories. Default off."
      },
      "rerankProvider": {
        "type": "string",
        "default": "local",
        "description": "Re-ranking provider: 'local' uses local LLM only. 'cloud' is reserved/experimental (currently treated as no-op).",
        "enum": [
          "local",
          "cloud"
        ]
      },
      "rerankMaxCandidates": {
        "type": "number",
        "default": 20,
        "description": "Max candidates to send to the re-ranker."
      },
      "rerankTimeoutMs": {
        "type": "number",
        "default": 8000,
        "description": "Timeout for re-ranking requests (ms). Fail-open on timeout."
      },
      "rerankCacheEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Cache re-ranking results in-memory for repeated queries."
      },
      "rerankCacheTtlMs": {
        "type": "number",
        "default": 3600000,
        "description": "TTL for in-memory re-ranking cache (ms)."
      },
      "feedbackEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable feedback capture tool for memory relevance (thumbs up/down)."
      },
      "negativeExamplesEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable negative examples (track retrieved-but-not-useful memories) and apply a small ranking penalty."
      },
      "negativeExamplesPenaltyPerHit": {
        "type": "number",
        "default": 0.05,
        "description": "Ranking penalty per negative example hit (keep small; QMD scores are ~0-1)."
      },
      "negativeExamplesPenaltyCap": {
        "type": "number",
        "default": 0.25,
        "description": "Maximum ranking penalty applied from negative examples."
      },
      "chunkingEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable automatic chunking of long memories"
      },
      "chunkingTargetTokens": {
        "type": "number",
        "default": 200,
        "description": "Target tokens per chunk"
      },
      "chunkingMinTokens": {
        "type": "number",
        "default": 150,
        "description": "Minimum tokens to trigger chunking"
      },
      "chunkingOverlapSentences": {
        "type": "number",
        "default": 2,
        "description": "Number of sentences to overlap between chunks"
      },
      "semanticChunkingEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable semantic chunking with embedding-based topic boundary detection (requires embedding provider)"
      },
      "semanticChunkingConfig": {
        "type": "object",
        "default": {},
        "description": "Optional overrides for the semantic chunking algorithm",
        "properties": {
          "targetTokens": {
            "type": "number",
            "default": 200,
            "description": "Target tokens per chunk"
          },
          "minTokens": {
            "type": "number",
            "default": 100,
            "description": "Minimum tokens for a segment before merging with neighbor"
          },
          "maxTokens": {
            "type": "number",
            "default": 400,
            "description": "Maximum tokens for a segment before recursive splitting"
          },
          "smoothingWindowSize": {
            "type": "number",
            "default": 3,
            "description": "Window size for the moving-average smoothing filter (auto-rounded to odd)"
          },
          "boundaryThresholdStdDevs": {
            "type": "number",
            "default": 1,
            "description": "Standard deviations below mean for boundary detection"
          },
          "embeddingBatchSize": {
            "type": "number",
            "default": 32,
            "description": "Batch size for embedding requests"
          },
          "fallbackToRecursive": {
            "type": "boolean",
            "default": true,
            "description": "Fall back to recursive chunking when embeddings are unavailable"
          }
        }
      },
      "contradictionDetectionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable automatic contradiction detection with LLM verification"
      },
      "contradictionSimilarityThreshold": {
        "type": "number",
        "default": 0.7,
        "description": "QMD similarity threshold to trigger contradiction check"
      },
      "contradictionMinConfidence": {
        "type": "number",
        "default": 0.9,
        "description": "Minimum LLM confidence to auto-resolve contradictions"
      },
      "contradictionAutoResolve": {
        "type": "boolean",
        "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)"
          }
        }
      },
      "patternReinforcementEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Run the pattern-reinforcement maintenance job (issue #687 PR 2/4): cluster duplicate non-procedural memories by normalized content, promote the most-recent member to canonical, and supersede the older duplicates. Off by default until bench validation lands."
      },
      "patternReinforcementCadenceMs": {
        "type": "integer",
        "minimum": 0,
        "default": 604800000,
        "description": "Minimum interval (ms) between pattern-reinforcement runs. Default 7 days. Set to 0 to disable cadence gating (manual / test invocation)."
      },
      "patternReinforcementMinCount": {
        "type": "integer",
        "minimum": 2,
        "maximum": 1000,
        "default": 3,
        "description": "Minimum cluster size before pattern reinforcement promotes a canonical and supersedes duplicates. Default 3."
      },
      "patternReinforcementCategories": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "default": [
          "preference",
          "fact",
          "decision"
        ],
        "description": "Memory categories the pattern-reinforcement job considers. Skips procedural memories so it stays disjoint from procedural mining. Default: preference, fact, decision."
      },
      "reinforcementRecallBoostEnabled": {
        "type": "boolean",
        "default": false,
        "description": "When true, memories with reinforcement_count frontmatter receive an additive recall score boost (issue #687 PR 3/4). Default: false (opt-in)."
      },
      "reinforcementRecallBoostWeight": {
        "type": "number",
        "minimum": 0,
        "maximum": 1,
        "default": 0.05,
        "description": "Score bonus per unit of reinforcement_count (weight * count, capped at max). Range [0, 1]. Default: 0.05."
      },
      "reinforcementRecallBoostMax": {
        "type": "number",
        "minimum": 0,
        "maximum": 1,
        "default": 0.3,
        "description": "Maximum additive reinforcement boost per result. Range [0, 1]. Default: 0.3."
      },
      "temporalSupersessionEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Mark older facts superseded when a new fact writes a conflicting value for the same entityRef + structuredAttribute key (issue #375)"
      },
      "temporalSupersessionIncludeInRecall": {
        "type": "boolean",
        "default": false,
        "description": "If true, include temporally-superseded facts in recall results (for audit/history). Default: exclude."
      },
      "recallDirectAnswerEnabled": {
        "type": "boolean",
        "default": false,
        "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."
      },
      "recallDisclosureEscalation": {
        "type": "string",
        "enum": [
          "manual",
          "auto"
        ],
        "default": "manual",
        "description": "Disclosure auto-escalation policy (issue #677 PR 4/4). When 'auto', recalls without an explicit caller-supplied disclosure escalate from chunk to section if the top-K confidence falls below recallDisclosureEscalationThreshold. 'raw' is never auto-selected. Default 'manual' preserves pre-#677 behavior."
      },
      "recallDisclosureEscalationThreshold": {
        "type": "number",
        "minimum": 0,
        "maximum": 1,
        "default": 0.5,
        "description": "Top-K confidence threshold (0-1) below which auto-escalation promotes chunk to section. Only consulted when recallDisclosureEscalation is 'auto'. Default 0.5."
      },
      "recallGraphEnabled": {
        "type": "boolean",
        "default": false,
        "description": "When true, recall builds a retrieval graph from memory frontmatter and runs Personalized PageRank, merging the result with QMD via MMR (issue #559 PR 4). Default false — ships off pending the retrieval-graph bench in PR 5."
      },
      "recallGraphDamping": {
        "type": "number",
        "minimum": 0,
        "maximum": 0.999999999,
        "default": 0.85,
        "description": "PPR damping factor used by the graph retrieval tier (issue #559)."
      },
      "recallGraphIterations": {
        "type": "integer",
        "minimum": 0,
        "maximum": 500,
        "default": 20,
        "description": "Maximum power-iteration rounds for PPR. Higher values trade latency for convergence."
      },
      "recallGraphTopK": {
        "type": "integer",
        "minimum": 0,
        "maximum": 10000,
        "default": 50,
        "description": "Maximum memories returned by the graph retrieval tier before the MMR diversifier runs."
      },
      "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."
      },
      "recallCrossNamespaceBudgetEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Cross-namespace query-budget limiter (issue #565). When true, a principal that issues a burst of recalls against namespaces other than their own is throttled once its per-window count crosses the hard limit. Ships disabled."
      },
      "recallCrossNamespaceBudgetWindowMs": {
        "type": "number",
        "minimum": 1,
        "default": 60000,
        "description": "Rolling window in ms over which cross-namespace reads are counted for the per-principal budget."
      },
      "recallCrossNamespaceBudgetSoftLimit": {
        "type": "number",
        "minimum": 0,
        "default": 10,
        "description": "Soft threshold for the cross-namespace budget: calls past this count are flagged but still allowed."
      },
      "recallCrossNamespaceBudgetHardLimit": {
        "type": "number",
        "minimum": 1,
        "default": 30,
        "description": "Hard threshold for the cross-namespace budget: calls past this count are denied until the window advances."
      },
      "recallAuditAnomalyDetectionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "When true, access surfaces (MCP, HTTP) run the anomaly detector over a tail of the audit trail after each recall and surface flags via logs/metrics. Ships disabled — enable explicitly."
      },
      "recallAuditAnomalyWindowMs": {
        "type": "number",
        "minimum": 1,
        "default": 300000,
        "description": "Rolling window (ms) over which audit entries are analyzed by the anomaly detector. Default 5 minutes."
      },
      "recallAuditAnomalyRepeatQueryLimit": {
        "type": "number",
        "minimum": 1,
        "default": 5,
        "description": "Threshold for the repeat-query anomaly flag: number of identical queries within the window before flagging."
      },
      "recallAuditAnomalyNamespaceWalkLimit": {
        "type": "number",
        "minimum": 1,
        "default": 3,
        "description": "Threshold for the namespace-walk anomaly flag: number of distinct namespaces queried within the window before flagging."
      },
      "recallAuditAnomalyHighCardinalityLimit": {
        "type": "number",
        "minimum": 1,
        "default": 50,
        "description": "Threshold for the high-cardinality-return anomaly flag: number of distinct results returned within the window before flagging."
      },
      "recallAuditAnomalyRapidFireLimit": {
        "type": "number",
        "minimum": 1,
        "default": 30,
        "description": "Threshold for the rapid-fire anomaly flag: number of recall requests within the window before flagging."
      },
      "recallMemoryWorthFilterEnabled": {
        "type": "boolean",
        "default": true,
        "description": "When true, recall multiplies candidate scores by the Memory Worth factor (mw_success / mw_fail counters, see issue #560). Memories with a history of failed sessions sink; neutral/uninstrumented memories are untouched. PR 5 bench: +0.60 precision@5 vs baseline on all 50 seeded cases. Operators can opt out with false."
      },
      "recallMemoryWorthHalfLifeMs": {
        "type": "number",
        "minimum": 0,
        "default": 0,
        "description": "Half-life (ms) for Memory Worth decay. Positive values exponentially decay older outcomes toward the neutral prior; 0 disables decay."
      },
      "memoryLinkingEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable automatic memory linking to build knowledge graph"
      },
      "threadingEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable conversation threading"
      },
      "threadingGapMinutes": {
        "type": "number",
        "default": 30,
        "description": "Minutes of gap to start a new thread"
      },
      "summarizationEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable automatic memory summarization/compression"
      },
      "summarizationTriggerCount": {
        "type": "number",
        "default": 1000,
        "description": "Memory count threshold to trigger summarization"
      },
      "summarizationRecentToKeep": {
        "type": "number",
        "default": 300,
        "description": "Number of recent memories to keep uncompressed"
      },
      "summarizationImportanceThreshold": {
        "type": "number",
        "default": 0.3,
        "description": "Only compress memories with importance below this threshold"
      },
      "summarizationProtectedTags": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "default": [
          "commitment",
          "preference",
          "decision",
          "principle"
        ],
        "description": "Tags that protect memories from compression"
      },
      "topicExtractionEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable topic extraction during consolidation"
      },
      "topicExtractionTopN": {
        "type": "number",
        "default": 50,
        "description": "Number of top topics to extract"
      },
      "transcriptEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable transcript archiving"
      },
      "captureMode": {
        "type": "string",
        "enum": [
          "implicit",
          "explicit",
          "hybrid"
        ],
        "default": "implicit",
        "description": "Memory capture policy. implicit preserves normal extraction, explicit stores only structured capture, and hybrid allows both."
      },
      "transcriptRetentionDays": {
        "type": "number",
        "default": 7,
        "description": "Days to retain transcript entries"
      },
      "transcriptSkipChannelTypes": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "default": [
          "cron"
        ],
        "description": "Channel types to skip from transcript logging (e.g., cron)"
      },
      "transcriptRecallHours": {
        "type": "number",
        "default": 12,
        "description": "Hours of transcript history to recall"
      },
      "maxTranscriptTurns": {
        "type": "number",
        "default": 50,
        "description": "Maximum transcript turns to include"
      },
      "maxTranscriptTokens": {
        "type": "number",
        "default": 1000,
        "description": "Maximum tokens for transcript context"
      },
      "checkpointEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable conversation checkpoints"
      },
      "checkpointTurns": {
        "type": "number",
        "default": 15,
        "description": "Number of turns per checkpoint"
      },
      "compactionResetEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Trigger session reset after compaction with BOOT.md recovery context (requires OC fork with api.resetSession)"
      },
      "hourlySummariesEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable hourly conversation summaries"
      },
      "daySummaryEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable end-of-day summary generation via engram.day_summary MCP tool"
      },
      "daySummaryTimezone": {
        "type": "string",
        "default": "",
        "description": "Timezone for the day summary cron (e.g. 'America/Lima'). When empty, uses the server timezone."
      },
      "summaryRecallHours": {
        "type": "number",
        "default": 24,
        "description": "Hours of summary history to recall"
      },
      "maxSummaryCount": {
        "type": "number",
        "default": 6,
        "description": "Maximum number of summaries to include"
      },
      "summaryModel": {
        "type": "string",
        "description": "Model for hourly summaries (defaults to main model)"
      },
      "modelSource": {
        "type": "string",
        "enum": [
          "plugin",
          "gateway"
        ],
        "default": "gateway",
        "description": "LLM source: 'gateway' delegates to a gateway agent's model chain (agents.list[]); 'plugin' uses Engram's own openai/localLlm config."
      },
      "gatewayAgentId": {
        "type": "string",
        "default": "",
        "description": "Agent persona ID (from openclaw.json agents.list[]) whose model chain to use for extraction, consolidation, and summarization. Required when modelSource is 'gateway'. Falls back to agents.defaults.model if empty."
      },
      "fastGatewayAgentId": {
        "type": "string",
        "default": "",
        "description": "Agent persona ID for fast-tier ops (rerank, entity summaries, compression guidelines). When modelSource is 'gateway' and this is empty, fast ops use the same chain as gatewayAgentId."
      },
      "taskModelChain": {
        "type": "object",
        "description": "Optional task-specific gateway model chain for Remnic's background LLM work (extraction, fact/profile/identity consolidation, summarization, causal consolidation). When set, this chain is resolved through gateway providers instead of gatewayAgentId or agents.defaults.model. Only applies when modelSource is 'gateway'.",
        "required": [
          "primary"
        ],
        "additionalProperties": false,
        "properties": {
          "primary": {
            "type": "string",
            "minLength": 1,
            "description": "Primary gateway model, e.g. zai/glm-4.7-flash"
          },
          "fallbacks": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "default": [],
            "description": "Fallback gateway models tried after primary"
          }
        }
      },
      "localLlmEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable local LLM for extraction and summarization (e.g., LM Studio, Ollama)"
      },
      "localLlmUrl": {
        "type": "string",
        "default": "http://localhost:1234/v1",
        "description": "URL for local LLM OpenAI-compatible endpoint"
      },
      "localLlmModel": {
        "type": "string",
        "default": "local-model",
        "description": "Model name for local LLM requests"
      },
      "localLlmApiKey": {
        "type": "string",
        "description": "Optional API key for authenticated OpenAI-compatible local endpoints"
      },
      "localLlmHeaders": {
        "type": "object",
        "description": "Optional additional headers for local/compatible endpoint requests",
        "additionalProperties": {
          "type": "string"
        }
      },
      "localLlmAuthHeader": {
        "type": "boolean",
        "default": true,
        "description": "If false, do not send Authorization header even when localLlmApiKey is set"
      },
      "localLlmFallback": {
        "type": "boolean",
        "default": true,
        "description": "Fall back to cloud OpenAI if local LLM is unavailable"
      },
      "localLlmHomeDir": {
        "type": "string",
        "description": "Optional home directory override for local LLM helpers (LM Studio settings + CLI PATH resolution)."
      },
      "localLmsCliPath": {
        "type": "string",
        "description": "Optional absolute path to LMS CLI binary. Preferred over auto-detected locations."
      },
      "localLmsBinDir": {
        "type": "string",
        "description": "Optional bin directory prepended to PATH for LMS CLI execution."
      },
      "localLlmTimeoutMs": {
        "type": "number",
        "default": 180000,
        "description": "Hard timeout for local LLM requests (ms)"
      },
      "slowLogEnabled": {
        "type": "boolean",
        "default": false,
        "description": "If enabled, log slow operations (durations + metadata; never logs content)"
      },
      "slowLogThresholdMs": {
        "type": "number",
        "default": 30000,
        "description": "Threshold for slow operation logging (ms)"
      },
      "traceRecallContent": {
        "type": "boolean",
        "default": false,
        "description": "If true, include the full recalled memory text in RecallTraceEvent.recalledContent emitted to __openclawEngramTrace subscribers (e.g. Langfuse). Disabled by default - only enable when you want external trace collectors to capture memory context."
      },
      "profilingEnabled": {
        "type": "boolean",
        "default": false,
        "description": "If true, enable performance profiling for recall and extraction pipelines. Profiling data is stored locally in the profiling storage directory."
      },
      "profilingStorageDir": {
        "type": "string",
        "default": "",
        "description": "Directory path for storing profiling trace files. Defaults to <memoryDir>/profiling if empty."
      },
      "profilingMaxTraces": {
        "type": "number",
        "default": 100,
        "description": "Maximum number of profiling trace files to retain. Oldest traces are pruned when this limit is exceeded."
      },
      "extractionDedupeEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable deduplication of near-identical extraction batches within a time window."
      },
      "extractionDedupeWindowMs": {
        "type": "number",
        "default": 300000,
        "description": "Window for extraction dedupe fingerprints (ms)."
      },
      "extractionMinChars": {
        "type": "number",
        "default": 40,
        "description": "Minimum combined user/assistant characters required before extraction runs."
      },
      "extractionMinImportanceLevel": {
        "type": "string",
        "enum": [
          "trivial",
          "low",
          "normal",
          "high",
          "critical"
        ],
        "default": "low",
        "description": "Minimum locally-scored importance level required to persist an extracted fact. Facts below this level are dropped before write and counted toward the importance_gated metric. Default \"low\" drops only trivial turn-level chatter (greetings, single-word replies); raise to \"normal\" or higher for a stricter gate."
      },
      "extractionTelemetryPrefilterEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Skip semantic durable-memory extraction for mechanical action/state telemetry transcripts that contain no durable-memory cue. Raw transcript storage and recall still run. Disable this if you intentionally want fact extraction from action logs."
      },
      "extractionScopeClassificationEnabled": {
        "type": "boolean",
        "default": true,
        "description": "When enabled, the extraction prompt instructs the LLM to classify each fact as 'project' (codebase-specific) or 'global' (cross-project knowledge). Global-scoped facts are promoted to the shared namespace so they are visible across all projects. Disable to restore pre-scope-classification behavior where all facts go to the session namespace."
      },
      "extractionJudgeEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable the LLM-as-judge fact-worthiness gate. When enabled, extracted facts are evaluated for durability before being persisted. Off by default (opt-in)."
      },
      "extractionJudgeModel": {
        "type": "string",
        "default": "",
        "description": "Model override for the extraction judge LLM. Empty string uses the configured local model."
      },
      "extractionJudgeBatchSize": {
        "type": "number",
        "default": 20,
        "minimum": 1,
        "description": "Maximum number of candidate facts sent to the judge LLM in a single batch call."
      },
      "extractionJudgeShadow": {
        "type": "boolean",
        "default": false,
        "description": "Shadow mode for the extraction judge. When true, judge verdicts are logged but all facts are still persisted regardless of the verdict."
      },
      "extractionJudgeMaxDeferrals": {
        "type": "number",
        "default": 2,
        "minimum": 1,
        "description": "Maximum number of times the same candidate text may be deferred by the extraction judge before the verdict is forcibly converted to 'reject'. Prevents pathological LLM responses from looping forever on ambiguous facts (issue #562)."
      },
      "extractionJudgeTelemetryEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Emit structured telemetry rows to state/observation-ledger/extraction-judge-verdicts.jsonl on every judge verdict. Off by default; enable to collect defer-rate and latency metrics for operator dashboards (issue #562)."
      },
      "collectJudgeTrainingPairs": {
        "type": "boolean",
        "default": false,
        "description": "Opt-in collector for (candidate_text, verdict_kind, reason) tuples used to prep a future GRPO training pipeline. Rows land under ~/.remnic/judge-training/<date>.jsonl (NOT in the shared memory directory). Off by default (issue #562)."
      },
      "judgeTrainingDir": {
        "type": "string",
        "default": "",
        "description": "Override directory for judge training-pair collection. Empty string uses the default (~/.remnic/judge-training). Only consulted when collectJudgeTrainingPairs is true."
      },
      "inlineSourceAttributionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable inline source attribution markers on persisted facts for downstream provenance tracking."
      },
      "inlineSourceAttributionFormat": {
        "type": "string",
        "default": "[Source: agent={agent}, session={sessionId}, ts={ts}]",
        "description": "Template used when inline source attribution is enabled."
      },
      "extractionMinUserTurns": {
        "type": "number",
        "default": 1,
        "description": "Minimum number of user turns required before extraction runs."
      },
      "extractionMaxTurnChars": {
        "type": "number",
        "default": 4000,
        "description": "Maximum characters per turn fed to extraction (long turns are truncated)."
      },
      "extractionMaxFactsPerRun": {
        "type": "number",
        "default": 12,
        "description": "Maximum facts persisted from a single extraction run."
      },
      "extractionMaxEntitiesPerRun": {
        "type": "number",
        "default": 6,
        "description": "Maximum entities persisted from a single extraction run."
      },
      "extractionMaxQuestionsPerRun": {
        "type": "number",
        "default": 3,
        "description": "Maximum questions persisted from a single extraction run."
      },
      "extractionMaxProfileUpdatesPerRun": {
        "type": "number",
        "default": 4,
        "description": "Maximum profile updates persisted from a single extraction run."
      },
      "consolidationRequireNonZeroExtraction": {
        "type": "boolean",
        "default": true,
        "description": "Only schedule consolidation when the last extraction produced durable outputs."
      },
      "consolidationMinIntervalMs": {
        "type": "number",
        "default": 600000,
        "description": "Minimum interval between consolidation runs (ms)."
      },
      "qmdMaintenanceEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable debounced background QMD maintenance instead of immediate updates on extraction."
      },
      "qmdMaintenanceDebounceMs": {
        "type": "number",
        "default": 30000,
        "description": "Debounce window for background QMD maintenance updates (ms)."
      },
      "qmdAutoEmbedEnabled": {
        "type": "boolean",
        "default": false,
        "description": "If true, background QMD maintenance also runs embed on a throttled cadence."
      },
      "qmdEmbedMinIntervalMs": {
        "type": "number",
        "default": 3600000,
        "description": "Minimum interval between background QMD embed runs (ms)."
      },
      "qmdUpdateTimeoutMs": {
        "type": "number",
        "default": 90000,
        "description": "Timeout for QMD update command (ms). Increase if your index grows and updates exceed 30s."
      },
      "qmdUpdateMinIntervalMs": {
        "type": "number",
        "default": 900000,
        "description": "Minimum interval between QMD update executions (ms). Useful because current QMD update runs globally across collections."
      },
      "maintenanceNamespaceFanoutEnabled": {
        "type": "boolean",
        "default": true,
        "description": "When namespaces are enabled, let background maintenance enumerate live catalog namespaces in addition to configured default/shared/policy namespaces."
      },
      "maintenanceMaxNamespacesPerCycle": {
        "type": "number",
        "default": 20,
        "minimum": 1,
        "description": "Maximum namespaces a single maintenance job cycle may process. Default and shared namespaces keep priority inside this budget."
      },
      "maintenanceIncludeProjectNamespaces": {
        "type": "boolean",
        "default": true,
        "description": "Include dynamic project namespaces from the namespace catalog in background maintenance fanout."
      },
      "maintenanceIncludeBranchNamespaces": {
        "type": "boolean",
        "default": false,
        "description": "Include dynamic branch namespaces from the namespace catalog in background maintenance fanout. Defaults off to avoid high-cardinality branch churn."
      },
      "maintenanceIncludeTeamProjectNamespaces": {
        "type": "boolean",
        "default": true,
        "description": "Include dynamic team-project namespaces from the namespace catalog in background maintenance fanout."
      },
      "maintenanceNamespaceLockStaleMs": {
        "type": "number",
        "default": 600000,
        "minimum": 1,
        "description": "Stale threshold for per-job/per-namespace maintenance locks under state/maintenance-locks/."
      },
      "localLlmRetry5xxCount": {
        "type": "number",
        "default": 1,
        "description": "Number of retry attempts for local LLM 5xx responses."
      },
      "localLlmRetryBackoffMs": {
        "type": "number",
        "default": 400,
        "description": "Base backoff delay between local LLM retries (ms)."
      },
      "localLlm400TripThreshold": {
        "type": "number",
        "default": 5,
        "description": "Consecutive 400 responses before local LLM enters temporary cooldown."
      },
      "localLlm400CooldownMs": {
        "type": "number",
        "default": 120000,
        "description": "Cooldown duration after tripping local LLM 400 threshold (ms)."
      },
      "localLlmMaxContext": {
        "type": "number",
        "description": "Override the detected context window for local LLM. Set to 32768 if your LLM server defaults to 32K context despite the model supporting 128K."
      },
      "localLlmFastEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable a separate smaller/faster local LLM for quick operations (rerank, entity_summary, tmt_summary, compression_guideline)."
      },
      "localLlmFastModel": {
        "type": "string",
        "default": "",
        "description": "Model ID for fast-tier local LLM operations. Empty string uses the primary localLlmModel."
      },
      "localLlmFastUrl": {
        "type": "string",
        "description": "Endpoint for the fast-tier local LLM. Defaults to the same endpoint as localLlmUrl when not set."
      },
      "localLlmFastTimeoutMs": {
        "type": "number",
        "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 sent only 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,
        "description": "If true, Engram may attempt to auto-register an hourly summary cron job (default off)."
      },
      "nightlyGovernanceCronAutoRegister": {
        "type": "boolean",
        "default": false,
        "description": "If true, Engram may attempt to auto-register the nightly governance cron job (default off)."
      },
      "hourlySummariesExtendedEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable structured hourly summaries (topics/decisions/action items/rejections). Default off."
      },
      "hourlySummariesIncludeToolStats": {
        "type": "boolean",
        "default": false,
        "description": "Include tool usage counts in extended hourly summaries (requires tool usage capture)."
      },
      "hourlySummariesIncludeSystemMessages": {
        "type": "boolean",
        "default": false,
        "description": "Include system messages in extended hourly summaries (use with care)."
      },
      "hourlySummariesMaxTurnsPerRun": {
        "type": "number",
        "default": 200,
        "description": "Maximum transcript turns to consider per session per hourly summarizer run."
      },
      "conversationIndexEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable conversation chunk indexing + semantic recall hook (default off)."
      },
      "conversationIndexBackend": {
        "type": "string",
        "enum": [
          "qmd",
          "faiss"
        ],
        "default": "qmd",
        "description": "Backend for conversation indexing. qmd indexes chunk docs into a QMD collection; faiss uses the bundled Python sidecar and local FAISS artifacts under memoryDir/state/conversation-index/faiss."
      },
      "conversationIndexQmdCollection": {
        "type": "string",
        "default": "openclaw-engram-conversations",
        "description": "QMD collection to use for conversation chunk search (must be configured in ~/.config/qmd/index.yml)."
      },
      "conversationIndexRetentionDays": {
        "type": "number",
        "default": 30,
        "description": "Days to retain conversation chunk docs."
      },
      "conversationIndexMinUpdateIntervalMs": {
        "type": "number",
        "default": 900000,
        "description": "Minimum interval between conversation_index_update runs per session (ms). Prevents redundant reindex churn."
      },
      "conversationIndexEmbedOnUpdate": {
        "type": "boolean",
        "default": false,
        "description": "If true, conversation_index_update also runs QMD embed by default. Keep false for lower load."
      },
      "conversationIndexFaissScriptPath": {
        "type": "string",
        "default": "",
        "description": "Optional absolute path to FAISS sidecar script. If unset, uses built-in default script location."
      },
      "conversationIndexFaissPythonBin": {
        "type": "string",
        "default": "",
        "description": "Optional Python executable used to run the FAISS sidecar (for example python3.11)."
      },
      "conversationIndexFaissModelId": {
        "type": "string",
        "default": "text-embedding-3-small",
        "description": "Embedding model identifier passed to the FAISS sidecar. By default the sidecar aliases OpenAI embedding ids to a local sentence-transformers model when REMNIC_FAISS_ENABLE_ST=1 (or legacy ENGRAM_FAISS_ENABLE_ST=1), and otherwise falls back to deterministic hash embeddings."
      },
      "conversationIndexFaissIndexDir": {
        "type": "string",
        "default": "state/conversation-index/faiss",
        "description": "Relative directory under memoryDir where FAISS sidecar artifacts are stored, including index.faiss, metadata.jsonl, and manifest.json."
      },
      "conversationIndexFaissUpsertTimeoutMs": {
        "type": "number",
        "default": 30000,
        "description": "Timeout (ms) for FAISS upsert operations."
      },
      "conversationIndexFaissSearchTimeoutMs": {
        "type": "number",
        "default": 5000,
        "description": "Timeout (ms) for FAISS search operations."
      },
      "conversationIndexFaissHealthTimeoutMs": {
        "type": "number",
        "default": 2000,
        "description": "Timeout (ms) for FAISS health checks. Health is fail-open and reports degraded when dependencies or local artifacts are missing."
      },
      "conversationIndexFaissMaxBatchSize": {
        "type": "number",
        "default": 512,
        "description": "Maximum transcript chunk batch size per FAISS upsert call."
      },
      "conversationIndexFaissMaxSearchK": {
        "type": "number",
        "default": 50,
        "description": "Maximum top-K allowed for FAISS search requests."
      },
      "conversationRecallTopK": {
        "type": "number",
        "default": 3,
        "description": "Top-K conversation chunks to include."
      },
      "conversationRecallMaxChars": {
        "type": "number",
        "default": 2500,
        "description": "Max characters of semantic conversation recall to include."
      },
      "conversationRecallTimeoutMs": {
        "type": "number",
        "default": 800,
        "description": "Timeout for semantic conversation recall search (ms). Fail-open on timeout."
      },
      "evalHarnessEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Engram's benchmark/evaluation harness foundation for tracking benchmark packs and run summaries."
      },
      "evalShadowModeEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable shadow-mode evaluation workflows so future benchmark instrumentation can measure memory changes without changing live recall output."
      },
      "benchmarkBaselineSnapshotsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable versioned benchmark baseline snapshot artifacts under the eval store for later PR delta reporting."
      },
      "benchmarkStoredBaselineEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable stored baseline comparisons for benchmark delta reporting."
      },
      "benchmarkDeltaReporterEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable named-baseline delta reports so PR candidates can be compared against stored benchmark baselines."
      },
      "evalStoreDir": {
        "type": "string",
        "description": "Override the evaluation harness state directory (defaults to {memoryDir}/state/evals)."
      },
      "objectiveStateMemoryEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Engram's objective-state memory foundation for normalized world/tool state snapshots."
      },
      "objectiveStateSnapshotWritesEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Allow writing typed objective-state snapshots to the objective-state store."
      },
      "objectiveStateRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Add recall-relevant objective-state snapshots to recall context."
      },
      "objectiveStateStoreDir": {
        "type": "string",
        "description": "Override the objective-state memory directory (defaults to {memoryDir}/state/objective-state)."
      },
      "causalTrajectoryMemoryEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Engram's causal-trajectory memory foundation for typed goal-action-observation-outcome chains."
      },
      "causalTrajectoryStoreDir": {
        "type": "string",
        "description": "Override the causal-trajectory memory directory (defaults to {memoryDir}/state/causal-trajectories)."
      },
      "causalTrajectoryRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Add recall-relevant causal trajectories to recall context."
      },
      "trustZonesEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Engram's trust-zone memory foundation for quarantine, working, and trusted records."
      },
      "quarantinePromotionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Reserve future promotion flows from quarantine into higher-trust zones."
      },
      "trustZoneStoreDir": {
        "type": "string",
        "description": "Override the trust-zone store directory (defaults to {memoryDir}/state/trust-zones)."
      },
      "trustZoneRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Add recall-relevant working and trusted trust-zone records to recall context."
      },
      "memoryPoisoningDefenseEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable deterministic provenance trust scoring for trust-zone records as the first poisoning-defense surface."
      },
      "memoryRedTeamBenchEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable operator-facing memory red-team benchmark packs and status accounting for poisoning-defense regression suites."
      },
      "harmonicRetrievalEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable harmonic retrieval blending over abstraction nodes and cue anchors, including recall-section assembly and harmonic-search diagnostics."
      },
      "abstractionAnchorsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable typed cue-anchor indexing for abstraction nodes and expose it through cue-anchor status tooling."
      },
      "abstractionNodeStoreDir": {
        "type": "string",
        "description": "Override the abstraction-node store directory (defaults to {memoryDir}/state/abstraction-nodes)."
      },
      "verifiedRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Add recall-relevant memory boxes only when their cited source memories verify as non-archived episodes."
      },
      "semanticRulePromotionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable deterministic promotion of explicit IF/THEN rules from verified episodic memories."
      },
      "semanticRuleVerificationEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Verify promoted semantic rules against their cited source episodes at recall time before surfacing them in recall."
      },
      "semanticConsolidationEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable periodic semantic consolidation of similar memories."
      },
      "semanticConsolidationModel": {
        "type": "string",
        "default": "auto",
        "description": "LLM for consolidation synthesis: 'auto' (primary model), 'fast' (fast local model), or a specific model name."
      },
      "semanticConsolidationThreshold": {
        "type": "number",
        "default": 0.8,
        "description": "Token overlap threshold (0-1) for grouping similar memories. 0.8=conservative, 0.6=aggressive."
      },
      "semanticConsolidationMinClusterSize": {
        "type": "number",
        "default": 3,
        "description": "Minimum cluster size before consolidation triggers."
      },
      "semanticConsolidationExcludeCategories": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "default": [
          "correction",
          "commitment",
          "procedure"
        ],
        "description": "Memory categories excluded from semantic consolidation."
      },
      "semanticConsolidationIntervalHours": {
        "type": "number",
        "default": 168,
        "description": "Hours between automatic consolidation runs (168 = weekly)."
      },
      "semanticConsolidationMaxPerRun": {
        "type": "number",
        "default": 100,
        "description": "Max memories to consolidate per run to limit LLM cost."
      },
      "operatorAwareConsolidationEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Opt in to operator-aware consolidation instructions so the LLM returns structured {operator, output} JSON and SPLIT/MERGE/UPDATE is recorded on derived_via. When disabled (default), derived_via still populates via the cluster-shape heuristic."
      },
      "peerProfileReasonerEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable the async peer profile reasoner (issue #679). Runs after semantic consolidation in the REM phase and updates per-peer profile.md files with provenance-tagged field updates derived from the peer's interaction log. Default off (opt-in)."
      },
      "peerProfileReasonerModel": {
        "type": "string",
        "default": "auto",
        "description": "Model identifier used by the peer profile reasoner. 'auto' inherits the gateway's primary chain (recommended). Logged for telemetry only — actual dispatch routes through the same FallbackLlmClient used by semantic consolidation."
      },
      "peerProfileReasonerMinInteractions": {
        "type": "number",
        "default": 5,
        "minimum": 0,
        "description": "Minimum new interaction-log entries a peer must accumulate since the previous reasoner run before being processed again. Set to 0 to consider every peer on every run."
      },
      "peerProfileReasonerMaxFieldsPerRun": {
        "type": "number",
        "default": 8,
        "minimum": 0,
        "description": "Hard cap on the total number of profile fields the reasoner will apply across all peers in a single run. Set to 0 to disable applying any fields."
      },
      "peerProfileRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "When true, add the active peer's profile fields to the recall context as a '## Peer Profile' section (issue #679 PR 3/5). Requires the session's peer ID to be registered before recall. Default off (opt-in)."
      },
      "peerProfileRecallMaxFields": {
        "type": "number",
        "default": 5,
        "minimum": 0,
        "description": "Maximum number of peer profile fields to add per recall call. Only the most-recently-updated N fields are included. Set to 0 to disable field inclusion even when peerProfileRecallEnabled is true."
      },
      "creationMemoryEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable creation-memory foundations, including the work-product ledger for explicit outputs agents create."
      },
      "memoryUtilityLearningEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable utility-learning telemetry storage so later slices can learn promotion and ranking weights from downstream outcomes."
      },
      "promotionByOutcomeEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable outcome-aware promotion controls that consume learned utility signals when later rollout slices activate them."
      },
      "commitmentLedgerEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable the explicit commitment ledger for promises, follow-ups, deadlines, and unfinished obligations."
      },
      "commitmentLifecycleEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable commitment lifecycle transitions, stale tracking, and resolved-entry cleanup for the commitment ledger."
      },
      "commitmentStaleDays": {
        "type": "number",
        "default": 14,
        "description": "Days before an open commitment without a due date is considered stale in lifecycle status."
      },
      "commitmentLedgerDir": {
        "type": "string",
        "description": "Override the commitment ledger directory (defaults to {memoryDir}/state/commitment-ledger)."
      },
      "resumeBundlesEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable deterministic resume-bundle storage and operator-facing handoff bundle commands."
      },
      "resumeBundleDir": {
        "type": "string",
        "description": "Override the resume-bundle directory (defaults to {memoryDir}/state/resume-bundles)."
      },
      "workProductRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Add recall-relevant work-product ledger entries to recall context and expose artifact-recovery search tooling."
      },
      "workProductLedgerDir": {
        "type": "string",
        "description": "Override the work-product ledger directory (defaults to {memoryDir}/state/work-product-ledger)."
      },
      "workTasksEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable task tracking within the work product system."
      },
      "workProjectsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable project tracking within the work product system."
      },
      "workTasksDir": {
        "type": "string",
        "description": "Override the work tasks directory (defaults to {memoryDir}/work/tasks)."
      },
      "workProjectsDir": {
        "type": "string",
        "description": "Override the work projects directory (defaults to {memoryDir}/work/projects)."
      },
      "workIndexEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable search index for work tasks and projects."
      },
      "workIndexDir": {
        "type": "string",
        "description": "Override the work index directory (defaults to {memoryDir}/work/index)."
      },
      "workTaskIndexEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Include tasks in the work search index."
      },
      "workProjectIndexEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Include projects in the work search index."
      },
      "workIndexAutoRebuildEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Automatically rebuild the work index when tasks or projects change."
      },
      "workIndexAutoRebuildDebounceMs": {
        "type": "number",
        "default": 1000,
        "description": "Debounce delay in ms before triggering auto-rebuild of the work index."
      },
      "actionGraphRecallEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Write action-conditioned causal-stage edges from typed trajectory records into the causal graph."
      },
      "namespacesEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable multi-agent namespaces (v3.0). Default off."
      },
      "namespaceCatalogEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable the rebuildable namespace catalog (issue #1499). Records cheap, failure-tolerant namespace touches in <memoryDir>/state/namespaces.jsonl for enumeration by maintenance, QMD indexing, dashboard, and doctor. Inert unless namespacesEnabled is also true; filesystem memory stays the source of truth and the catalog is rebuildable via `remnic namespaces rebuild`. Default on; set false to opt out."
      },
      "defaultNamespace": {
        "type": "string",
        "default": "default",
        "description": "Default namespace name."
      },
      "sharedNamespace": {
        "type": "string",
        "default": "shared",
        "description": "Shared namespace name."
      },
      "principalFromSessionKeyMode": {
        "type": "string",
        "enum": [
          "map",
          "prefix",
          "regex"
        ],
        "default": "map",
        "description": "How to derive principal identity from sessionKey."
      },
      "principalFromSessionKeyRules": {
        "type": "array",
        "description": "Rules for resolving principal from sessionKey (ordered).",
        "items": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "match": {
              "type": "string"
            },
            "principal": {
              "type": "string"
            }
          },
          "required": [
            "match",
            "principal"
          ]
        }
      },
      "namespacePolicies": {
        "type": "array",
        "description": "Namespace access policies.",
        "items": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "name": {
              "type": "string"
            },
            "readPrincipals": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "writePrincipals": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "includeInRecallByDefault": {
              "type": "boolean"
            }
          },
          "required": [
            "name",
            "readPrincipals",
            "writePrincipals"
          ]
        }
      },
      "defaultRecallNamespaces": {
        "type": "array",
        "description": "Which namespaces to include by default in recall.",
        "items": {
          "type": "string",
          "enum": [
            "self",
            "shared"
          ]
        },
        "default": [
          "self",
          "shared"
        ]
      },
      "scopeProfiles": {
        "type": "object",
        "default": {},
        "description": "Optional hosted-team memory scope profiles. Profiles define ordered read layers, the default write layer, and authorized promotion target aliases without changing behavior when absent.",
        "additionalProperties": {
          "type": "object",
          "properties": {
            "readOrder": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "userProject",
                  "teamProject",
                  "userGlobal",
                  "serverShared"
                ]
              }
            },
            "writeDefault": {
              "type": "string",
              "enum": [
                "userProject",
                "teamProject",
                "userGlobal",
                "serverShared"
              ]
            },
            "promotionTargets": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "userProject",
                  "teamProject",
                  "userGlobal",
                  "serverShared"
                ]
              }
            },
            "teamProject": {
              "type": "object",
              "properties": {
                "namespaceTemplate": {
                  "type": "string"
                },
                "teamId": {
                  "type": "string"
                }
              }
            },
            "autoPromote": {
              "type": "object",
              "properties": {
                "enabled": {
                  "type": "boolean"
                },
                "targets": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "enum": [
                      "teamProject",
                      "serverShared",
                      "userGlobal",
                      "userProject"
                    ]
                  }
                },
                "categories": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "minConfidenceTier": {
                  "type": "string",
                  "enum": [
                    "explicit",
                    "implied",
                    "inferred",
                    "speculative"
                  ]
                }
              }
            }
          }
        }
      },
      "defaultScopeProfile": {
        "type": "string",
        "description": "Optional key in scopeProfiles to use as the default hosted memory scope profile."
      },
      "teams": {
        "type": "object",
        "default": {},
        "description": "Trusted team membership and team-project namespace templates used by scopeProfiles.",
        "additionalProperties": {
          "type": "object",
          "properties": {
            "principals": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "projectNamespaceTemplate": {
              "type": "string"
            },
            "read": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "write": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "promote": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      },
      "cronRecallMode": {
        "type": "string",
        "enum": [
          "all",
          "none",
          "allowlist"
        ],
        "default": "all",
        "description": "Recall behavior for cron sessions. Use allowlist to opt specific cron sessionKeys in."
      },
      "cronRecallAllowlist": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "default": [],
        "description": "Session-key wildcard patterns (supports *) allowed for recall when cronRecallMode=allowlist."
      },
      "cronRecallPolicyEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable prompt-shape-aware recall query normalization for cron sessions."
      },
      "cronRecallNormalizedQueryMaxChars": {
        "type": "number",
        "default": 480,
        "description": "Maximum query length (characters) used for cron recall retrieval after normalization."
      },
      "cronRecallInstructionHeavyTokenCap": {
        "type": "number",
        "default": 36,
        "description": "Maximum token count used to build compact retrieval queries for instruction-heavy cron prompts."
      },
      "cronConversationRecallMode": {
        "type": "string",
        "enum": [
          "auto",
          "always",
          "never"
        ],
        "default": "auto",
        "description": "Controls conversation semantic recall in cron sessions. auto skips it for instruction-heavy prompts."
      },
      "autoPromoteToSharedEnabled": {
        "type": "boolean",
        "default": false,
        "description": "If enabled, Engram may auto-promote selected categories to shared (reserved; conservative)."
      },
      "autoPromoteToSharedCategories": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "fact",
            "correction",
            "decision",
            "preference"
          ]
        },
        "default": [
          "fact",
          "correction",
          "decision",
          "preference"
        ],
        "description": "Categories eligible for auto-promotion to shared."
      },
      "autoPromoteMinConfidenceTier": {
        "type": "string",
        "enum": [
          "explicit",
          "implied"
        ],
        "default": "explicit",
        "description": "Minimum confidence tier for auto-promotion."
      },
      "routingRulesEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable custom memory routing rules (v8.7). Default off."
      },
      "routingRulesStateFile": {
        "type": "string",
        "default": "state/routing-rules.json",
        "description": "Relative path under memoryDir for persisted routing rules."
      },
      "sharedContextEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable shared-context assembly and tools (v4.0). Default off."
      },
      "sharedContextDir": {
        "type": "string",
        "description": "Override shared-context directory (default: ~/.openclaw/workspace/shared-context)."
      },
      "sharedContextMaxInjectChars": {
        "type": "number",
        "default": 4000,
        "description": "Max characters of shared-context to include in each recall context."
      },
      "crossSignalsSemanticEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable semantic cross-signal grouping (reserved/experimental)."
      },
      "crossSignalsSemanticTimeoutMs": {
        "type": "number",
        "default": 4000,
        "description": "Timeout for semantic cross-signal grouping (ms)."
      },
      "sharedCrossSignalSemanticEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable semantic cross-signal enhancer during shared-context daily curation."
      },
      "sharedCrossSignalSemanticTimeoutMs": {
        "type": "number",
        "default": 4000,
        "description": "Timeout budget for shared-context semantic cross-signal enhancer (ms)."
      },
      "sharedCrossSignalSemanticMaxCandidates": {
        "type": "number",
        "default": 120,
        "description": "Maximum candidate topic tokens considered by semantic cross-signal enhancer."
      },
      "compoundingEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable compounding engine (v5.0). Default off."
      },
      "compoundingWeeklyCronEnabled": {
        "type": "boolean",
        "default": false,
        "description": "If true, compounding weekly synthesis can be scheduled externally via cron."
      },
      "compoundingSemanticEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable semantic compounding synthesis (reserved/experimental)."
      },
      "compoundingSynthesisTimeoutMs": {
        "type": "number",
        "default": 15000,
        "description": "Timeout for compounding synthesis (ms)."
      },
      "compoundingInjectEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Inject compounded mistakes/patterns into recall when compounding is enabled."
      },
      "factDeduplicationEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable content-hash deduplication to prevent storing semantically identical facts."
      },
      "semanticDedupEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Issue #373 — enable write-time semantic similarity guard that skips near-duplicate facts by comparing embeddings to existing memories. Fails open when the embedding backend is unavailable."
      },
      "semanticDedupThreshold": {
        "type": "number",
        "default": 0.92,
        "minimum": 0,
        "maximum": 1,
        "description": "Cosine similarity threshold in [0, 1]. Candidate facts whose nearest neighbor scores at or above this value are treated as duplicates and skipped."
      },
      "semanticDedupCandidates": {
        "type": "number",
        "default": 5,
        "minimum": 0,
        "description": "Number of nearest-neighbor candidates to inspect during the write-time semantic dedup check. Set to 0 to disable the embedding lookup entirely (equivalent to semanticDedupEnabled=false)."
      },
      "factArchivalEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable automatic archival of old, low-importance, rarely-accessed facts during consolidation."
      },
      "factArchivalAgeDays": {
        "type": "number",
        "default": 90,
        "description": "Minimum age in days before a fact is eligible for archival."
      },
      "factArchivalMaxImportance": {
        "type": "number",
        "default": 0.3,
        "description": "Maximum importance score for archival eligibility (0-1). Only facts below this threshold are archived."
      },
      "factArchivalMaxAccessCount": {
        "type": "number",
        "default": 2,
        "description": "Maximum access count for archival eligibility. Only rarely-accessed facts are archived."
      },
      "factArchivalProtectedCategories": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "default": [
          "commitment",
          "preference",
          "decision",
          "principle",
          "procedure"
        ],
        "description": "Categories that protect a fact from archival regardless of other criteria."
      },
      "lifecyclePolicyEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable the lifecycle policy engine (hot↔cold tier migration, value scoring, decay). Default true since #686 PR 3/6 — flipping enables the year-2 retention story by default. Set to false to opt out."
      },
      "lifecycleFilterStaleEnabled": {
        "type": "boolean",
        "default": false,
        "description": "If enabled, stale lifecycle memories can be filtered from retrieval (wired in PR20D)."
      },
      "lifecyclePromoteHeatThreshold": {
        "type": "number",
        "default": 0.55,
        "description": "Heat threshold for lifecycle promotion to validated/active states."
      },
      "lifecycleStaleDecayThreshold": {
        "type": "number",
        "default": 0.65,
        "description": "Decay threshold for lifecycle demotion to stale."
      },
      "lifecycleArchiveDecayThreshold": {
        "type": "number",
        "default": 0.85,
        "description": "Decay threshold for lifecycle demotion to archived state semantics."
      },
      "lifecycleProtectedCategories": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "default": [
          "decision",
          "principle",
          "commitment",
          "preference",
          "procedure"
        ],
        "description": "Categories that lifecycle policy will not auto-archive."
      },
      "lifecycleMetricsEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Emit lifecycle metrics snapshots to state/lifecycle-metrics.json when policy is enabled."
      },
      "proactiveExtractionEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable proactive self-questioning extraction second-pass (v8.3, default off)."
      },
      "contextCompressionActionsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable context compression action tooling and telemetry paths (v8.3, default off)."
      },
      "compressionGuidelineLearningEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable adaptive compression guideline learning from memory-action outcomes (v8.3, default off)."
      },
      "compressionGuidelineSemanticRefinementEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable optional semantic refinement pass after deterministic guideline candidate generation (v8.11, default off)."
      },
      "compressionGuidelineSemanticTimeoutMs": {
        "type": "number",
        "default": 2500,
        "description": "Hard timeout in milliseconds for semantic refinement; timeout fail-opens to deterministic output."
      },
      "maxProactiveQuestionsPerExtraction": {
        "type": "number",
        "default": 2,
        "description": "Maximum proactive self-questions generated per extraction pass (0 disables question generation)."
      },
      "proactiveExtractionTimeoutMs": {
        "type": "number",
        "default": 2500,
        "description": "Hard timeout in milliseconds for proactive self-question generation and answer synthesis (0 disables the proactive second pass)."
      },
      "proactiveExtractionMaxTokens": {
        "type": "number",
        "default": 900,
        "description": "Token budget for each proactive extraction sub-call (0 disables the proactive second pass)."
      },
      "extractionMaxOutputTokens": {
        "type": "number",
        "default": 16384,
        "description": "Maximum output tokens (max_completion_tokens) for the direct-client extraction call."
      },
      "proactiveExtractionCategoryAllowlist": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional memory categories allowed from proactive second-pass writes. When omitted, proactive writes can emit any standard memory category."
      },
      "maxCompressionTokensPerHour": {
        "type": "number",
        "default": 1500,
        "description": "Hourly token budget for compression actions/guideline generation (0 disables budgeted compression work)."
      },
      "behaviorLoopAutoTuneEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable runtime behavior-loop policy auto-tuning (v8.15, default off)."
      },
      "behaviorLoopLearningWindowDays": {
        "type": "number",
        "default": 14,
        "description": "Rolling signal window used for behavior-loop policy learning (days; 0 allowed)."
      },
      "behaviorLoopMinSignalCount": {
        "type": "number",
        "default": 10,
        "description": "Minimum signal volume required before behavior-loop adjustments are emitted (0 allowed)."
      },
      "behaviorLoopMaxDeltaPerCycle": {
        "type": "number",
        "default": 0.1,
        "description": "Maximum absolute parameter delta allowed per learning cycle (0-1)."
      },
      "behaviorLoopProtectedParams": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "default": [
          "maxMemoryTokens",
          "qmdMaxResults",
          "qmdColdMaxResults",
          "recallPlannerMaxQmdResultsMinimal",
          "verbatimArtifactsMaxRecall"
        ],
        "description": "Runtime parameters that auto-tuning must never modify."
      },
      "searchBackend": {
        "type": "string",
        "enum": [
          "qmd",
          "remote",
          "noop",
          "lancedb",
          "meilisearch",
          "orama"
        ],
        "default": "qmd",
        "description": "Search backend: qmd (local hybrid), remote (HTTP REST), noop (disabled), lancedb (embedded hybrid), meilisearch (server-based), orama (embedded JS)"
      },
      "remoteSearchBaseUrl": {
        "type": "string",
        "description": "Base URL for remote search backend (when searchBackend=remote)"
      },
      "remoteSearchApiKey": {
        "type": "string",
        "description": "API key for remote search backend (when searchBackend=remote)"
      },
      "remoteSearchTimeoutMs": {
        "type": "number",
        "default": 30000,
        "description": "Timeout in ms for remote search backend requests"
      },
      "calibrationEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable recall calibration rules (v9.0, default off)."
      },
      "calibrationMaxRulesPerRecall": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of calibration rules to include per recall pass."
      },
      "calibrationMaxChars": {
        "type": "number",
        "default": 1200,
        "description": "Maximum characters of calibration content to include per recall pass."
      },
      "lancedbEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable LanceDB as a supplemental search backend."
      },
      "lanceDbPath": {
        "type": "string",
        "description": "Directory path for LanceDB storage (when searchBackend=lancedb)"
      },
      "lanceEmbeddingDimension": {
        "type": "number",
        "default": 1536,
        "description": "Embedding vector dimension for LanceDB (when searchBackend=lancedb)"
      },
      "meilisearchEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Meilisearch as a supplemental search backend."
      },
      "meilisearchHost": {
        "type": "string",
        "default": "http://localhost:7700",
        "description": "Meilisearch server host URL (when searchBackend=meilisearch)"
      },
      "meilisearchApiKey": {
        "type": "string",
        "description": "API key for Meilisearch (when searchBackend=meilisearch)"
      },
      "meilisearchTimeoutMs": {
        "type": "number",
        "default": 30000,
        "description": "Timeout in ms for Meilisearch requests (when searchBackend=meilisearch)"
      },
      "meilisearchAutoIndex": {
        "type": "boolean",
        "default": false,
        "description": "Automatically push local memory docs to Meilisearch on update (when searchBackend=meilisearch)"
      },
      "oramaEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Orama as a supplemental search backend."
      },
      "oramaDbPath": {
        "type": "string",
        "description": "Directory path for Orama persistence files (when searchBackend=orama)"
      },
      "oramaEmbeddingDimension": {
        "type": "number",
        "default": 1536,
        "description": "Embedding vector dimension for Orama (when searchBackend=orama)"
      },
      "qmdDaemonEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Prefer the shared QMD MCP session for faster searches when available."
      },
      "qmdDaemonUrl": {
        "type": "string",
        "default": "http://localhost:8181/mcp",
        "description": "Legacy compatibility setting retained for QMD daemon configuration."
      },
      "qmdDaemonRecheckIntervalMs": {
        "type": "number",
        "default": 60000,
        "description": "Re-probe interval when daemon is down (ms)"
      },
      "qmdIntentHintsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Pass Engram's inferred recall intent into QMD unified search when supported."
      },
      "qmdExplainEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Request QMD explain traces for recall debugging when supported."
      },
      "knowledgeIndexEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Inject a compact Knowledge Index of top entities into every recall"
      },
      "knowledgeIndexMaxEntities": {
        "type": "number",
        "default": 40,
        "description": "Max entities included in the Knowledge Index"
      },
      "knowledgeIndexMaxChars": {
        "type": "number",
        "default": 4000,
        "description": "Hard character cap for the Knowledge Index section"
      },
      "entityRetrievalEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable entity-oriented recall hints for direct entity questions and short follow-up queries."
      },
      "entityRetrievalMaxChars": {
        "type": "number",
        "default": 2400,
        "description": "Hard character cap for the entity retrieval section."
      },
      "entityRetrievalMaxHints": {
        "type": "number",
        "default": 2,
        "description": "Maximum entity targets summarized in one recall pass."
      },
      "entityRetrievalMaxSupportingFacts": {
        "type": "number",
        "default": 6,
        "description": "Maximum supporting fact/timeline snippets considered per entity target."
      },
      "entityRetrievalMaxRelatedEntities": {
        "type": "number",
        "default": 3,
        "description": "Maximum related entities listed per target when confidence is high."
      },
      "entityRetrievalRecentTurns": {
        "type": "number",
        "default": 6,
        "description": "Recent transcript turns scanned for pronoun carry-forward and short follow-up resolution."
      },
      "entityRelationshipsEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Track entity-to-entity relationships during extraction"
      },
      "entityActivityLogEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Log timestamped activity per entity"
      },
      "entityActivityLogMaxEntries": {
        "type": "number",
        "default": 20,
        "description": "Max activity entries per entity before oldest are pruned"
      },
      "entityAliasesEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Store aliases per entity file"
      },
      "entitySummaryEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Generate LLM summaries for entities during consolidation"
      },
      "entitySynthesisMaxTokens": {
        "anyOf": [
          {
            "type": "integer",
            "const": 0
          },
          {
            "type": "integer",
            "minimum": 10
          }
        ],
        "default": 500,
        "description": "Max tokens used when refreshing an entity synthesis from its timeline."
      },
      "recallBudgetChars": {
        "type": "number",
        "description": "Hard character cap for total recall context. Defaults to maxMemoryTokens * 4."
      },
      "recallOuterTimeoutMs": {
        "type": "number",
        "default": 75000,
        "description": "Outer timeout in ms for the full recall pipeline."
      },
      "recallCoreDeadlineMs": {
        "type": "number",
        "default": 75000,
        "description": "Default deadline in ms recorded for core recall sections."
      },
      "recallEnrichmentDeadlineMs": {
        "type": "number",
        "default": 25000,
        "description": "Default deadline in ms recorded for enrichment recall sections."
      },
      "recallMmrEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Apply Maximal Marginal Relevance to the final recall selection per-section so one redundant cluster cannot dominate the included context."
      },
      "recallMmrLambda": {
        "type": "number",
        "default": 0.7,
        "minimum": 0,
        "maximum": 1,
        "description": "MMR lambda parameter. 1.0 = pure relevance, 0.0 = pure diversity. Default 0.7 tilts toward relevance with meaningful diversity."
      },
      "recallMmrTopN": {
        "type": "number",
        "default": 40,
        "minimum": 0,
        "description": "Number of top candidates per section to run MMR over. Candidates past this remain in original order."
      },
      "recallReasoningTraceBoostEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Boost stored reasoning_trace memories in recall results when the incoming query reads like a problem-solving ask (e.g. 'how do I...', 'step by step', 'walk me through...'). Default false - opt in after benchmarking (issue #564)."
      },
      "recallPipeline": {
        "type": "array",
        "description": "Ordered recall sections with per-section budgets and feature knobs.",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "enabled": {
              "type": "boolean",
              "default": true
            },
            "maxChars": {
              "type": [
                "number",
                "null"
              ]
            },
            "consolidateTriggerLines": {
              "type": "number"
            },
            "consolidateTargetLines": {
              "type": "number"
            },
            "maxEntities": {
              "type": "number"
            },
            "maxResults": {
              "type": "number"
            },
            "maxTurns": {
              "type": "number"
            },
            "maxTokens": {
              "type": "number"
            },
            "lookbackHours": {
              "type": "number"
            },
            "maxCount": {
              "type": "number"
            },
            "topK": {
              "type": "number"
            },
            "timeoutMs": {
              "type": "number"
            },
            "maxPatterns": {
              "type": "number"
            },
            "forceGeneric": {
              "type": "boolean"
            }
          },
          "required": [
            "id"
          ]
        }
      },
      "qmdRecallCacheTtlMs": {
        "type": "number",
        "default": 60000,
        "description": "Fresh TTL in ms for rendered QMD recall enrichment cache entries."
      },
      "qmdRecallCacheStaleTtlMs": {
        "type": "number",
        "default": 600000,
        "description": "Maximum stale TTL in ms for rendered QMD recall cache fallbacks."
      },
      "qmdRecallCacheMaxEntries": {
        "type": "number",
        "default": 128,
        "description": "Maximum in-memory rendered QMD recall cache entries before oldest eviction."
      },
      "lcmEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Lossless Context Management (LCM) subsystem"
      },
      "lcmLeafBatchSize": {
        "type": "number",
        "default": 8,
        "description": "Number of turns per leaf node in the LCM DAG"
      },
      "lcmRollupFanIn": {
        "type": "number",
        "default": 4,
        "description": "Number of children per rollup node in the LCM DAG"
      },
      "lcmFreshTailTurns": {
        "type": "number",
        "default": 16,
        "description": "Number of recent turns kept verbatim (not summarized)"
      },
      "lcmMaxDepth": {
        "type": "number",
        "default": 5,
        "description": "Maximum depth of the LCM summary DAG"
      },
      "lcmRecallBudgetShare": {
        "type": "number",
        "default": 0.15,
        "description": "Fraction of recall budget allocated to LCM compressed history (0-1)"
      },
      "lcmDeterministicMaxTokens": {
        "type": "number",
        "default": 512,
        "description": "Max tokens for deterministic (non-LLM) summaries"
      },
      "lcmTelemetryPrefilterEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Use deterministic LCM compression for mechanical action/state telemetry without durable-memory cues."
      },
      "lcmArchiveRetentionDays": {
        "type": "number",
        "default": 90,
        "description": "Days to retain archived LCM summaries"
      },
      "lcmObserveConcurrency": {
        "type": "number",
        "default": 1,
        "description": "Maximum independent LCM observe jobs to process concurrently."
      },
      "messagePartsEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Opt in to structured LCM message-part capture for tool calls, file references, patches, and reasoning markers."
      },
      "messagePartsRecallMaxResults": {
        "type": "number",
        "default": 6,
        "description": "Maximum structured message-part matches to include in recall when messagePartsEnabled is true."
      },
      "ircEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable Inductive Rule Consolidation (IRC) subsystem (default on)."
      },
      "ircMaxPreferences": {
        "type": "number",
        "default": 20,
        "description": "Maximum number of preferences to include in IRC rules."
      },
      "ircIncludeCorrections": {
        "type": "boolean",
        "default": true,
        "description": "Include corrections when building IRC rules (default on)."
      },
      "ircMinConfidence": {
        "type": "number",
        "default": 0.3,
        "description": "Minimum confidence threshold for an IRC rule to be included (0-1)."
      },
      "cmcEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable Causal Memory Consolidation (CMC) subsystem (default off)."
      },
      "cmcStitchLookbackDays": {
        "type": "number",
        "default": 7,
        "description": "Number of days to look back when stitching causal trajectories."
      },
      "cmcStitchMinScore": {
        "type": "number",
        "default": 2.5,
        "description": "Minimum score for a causal edge to be stitched into a trajectory."
      },
      "cmcStitchMaxEdgesPerTrajectory": {
        "type": "number",
        "default": 3,
        "description": "Maximum edges per trajectory during CMC stitching."
      },
      "cmcConsolidationEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable CMC consolidation pass (default off)."
      },
      "cmcConsolidationMinRecurrence": {
        "type": "number",
        "default": 3,
        "description": "Minimum recurrence count before a CMC pattern is consolidated."
      },
      "cmcConsolidationMinSessions": {
        "type": "number",
        "default": 2,
        "description": "Minimum sessions a CMC pattern must appear in before consolidation."
      },
      "cmcConsolidationSuccessThreshold": {
        "type": "number",
        "default": 0.7,
        "description": "Minimum success ratio required to consolidate a CMC pattern (0-1)."
      },
      "cmcRetrievalEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable CMC retrieval at recall time (default off)."
      },
      "cmcRetrievalMaxDepth": {
        "type": "number",
        "default": 3,
        "description": "Maximum graph depth traversed during CMC retrieval."
      },
      "cmcRetrievalMaxChars": {
        "type": "number",
        "default": 800,
        "description": "Maximum characters of CMC content included per recall pass."
      },
      "cmcRetrievalCounterfactualBoost": {
        "type": "number",
        "default": 0.4,
        "description": "Score boost applied to counterfactual nodes during CMC retrieval (0-1)."
      },
      "cmcBehaviorLearningEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable CMC behavior pattern learning (default off)."
      },
      "cmcBehaviorMinFrequency": {
        "type": "number",
        "default": 3,
        "description": "Minimum frequency for a behavior pattern to be learned by CMC."
      },
      "cmcBehaviorMinSessions": {
        "type": "number",
        "default": 2,
        "description": "Minimum sessions a behavior must appear in before CMC learns it."
      },
      "cmcBehaviorConfidenceThreshold": {
        "type": "number",
        "default": 0.6,
        "description": "Minimum confidence threshold for CMC behavior patterns (0-1)."
      },
      "cmcLifecycleCausalImpactWeight": {
        "type": "number",
        "default": 0.05,
        "description": "Weight of causal impact score in CMC lifecycle scoring."
      },
      "parallelRetrievalEnabled": {
        "type": "boolean",
        "default": false,
        "description": "Enable three-agent parallel retrieval (DirectFact + Contextual + Temporal). Zero additional LLM cost. Default false."
      },
      "parallelAgentWeights": {
        "type": "object",
        "default": {
          "direct": 1,
          "contextual": 0.7,
          "temporal": 0.85
        },
        "description": "Score weights per retrieval agent source applied during result merge."
      },
      "parallelMaxResultsPerAgent": {
        "type": "number",
        "default": 20,
        "description": "Maximum results fetched per agent before merge."
      },
      "briefing": {
        "type": "object",
        "additionalProperties": false,
        "default": {
          "enabled": true,
          "defaultWindow": "yesterday",
          "defaultFormat": "markdown",
          "maxFollowups": 5,
          "calendarSource": null,
          "saveByDefault": false,
          "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": {
        "type": "boolean",
        "default": false,
        "description": "Enable the external enrichment pipeline (#365). When true, entities can be enriched via registered providers."
      },
      "enrichmentAutoOnCreate": {
        "type": "boolean",
        "default": false,
        "description": "Automatically enrich newly created entities when the enrichment pipeline is enabled."
      },
      "enrichmentMaxCandidatesPerEntity": {
        "type": "integer",
        "default": 20,
        "minimum": 0,
        "description": "Maximum enrichment candidates accepted per entity per run. Set to 0 to accept none."
      }
    }
  },
  "uiHints": {
    "openaiApiKey": {
      "label": "OpenAI API Key",
      "sensitive": true,
      "placeholder": "sk-...",
      "help": "Optional API key for plugin mode only. Not needed when Model Source is gateway."
    },
    "openaiBaseUrl": {
      "label": "OpenAI Base URL",
      "advanced": true,
      "placeholder": "https://api.openai.com/v1",
      "help": "Override for OpenAI-compatible providers (Scryr, Together, OpenRouter, etc.)"
    },
    "model": {
      "label": "Extraction Model",
      "advanced": true,
      "placeholder": "gpt-5.5"
    },
    "reasoningEffort": {
      "label": "Reasoning Effort",
      "advanced": true
    },
    "triggerMode": {
      "label": "Trigger Mode",
      "advanced": true
    },
    "bufferMaxTurns": {
      "label": "Buffer Max Turns",
      "advanced": true,
      "placeholder": "5"
    },
    "bufferMaxMinutes": {
      "label": "Buffer Max Minutes",
      "advanced": true,
      "placeholder": "15"
    },
    "consolidateEveryN": {
      "label": "Consolidation Frequency",
      "advanced": true,
      "placeholder": "3"
    },
    "maxMemoryTokens": {
      "label": "Max Memory Tokens",
      "advanced": true,
      "placeholder": "2000"
    },
    "memoryOsPreset": {
      "label": "Memory OS Preset",
      "advanced": true,
      "help": "Optional preset: conservative, balanced, research-max, or local-llm-heavy. `research` remains accepted as a backward-compatible alias. Explicit settings still win."
    },
    "qmdEnabled": {
      "label": "Enable QMD",
      "help": "Enable QMD for memory search/indexing"
    },
    "hostEmbeddingProviderEnabled": {
      "label": "Use Host Embeddings",
      "advanced": true,
      "help": "Prefer OpenClaw's registered embedding providers when available; Remnic falls back automatically."
    },
    "hostEmbeddingProviderId": {
      "label": "Host Embedding Provider",
      "advanced": true,
      "placeholder": "openai-compatible"
    },
    "hostEmbeddingProviderModel": {
      "label": "Host Embedding Model",
      "advanced": true,
      "placeholder": "text-embedding-3-small"
    },
    "openclawMessageReceivedCaptureEnabled": {
      "label": "Capture Inbound Messages",
      "advanced": true,
      "help": "Use OpenClaw message_received transcript capture when the host emits it."
    },
    "openclawReplyMetadataCaptureEnabled": {
      "label": "Capture Reply Metadata",
      "advanced": true,
      "help": "Store bounded message/thread/reply fields in transcript metadata."
    },
    "openclawReplyMetadataExtractionHintsEnabled": {
      "label": "Use Reply Extraction Hints",
      "advanced": true,
      "help": "Include bounded quoted-reply context in extraction prompts. Off by default."
    },
    "openclawChannelEnvelopeCleaningEnabled": {
      "label": "Clean Channel Envelopes",
      "advanced": true,
      "help": "Use OpenClaw's canonical channel envelope prefixes when available."
    },
    "openclawFlushPlanProcessingEnabled": {
      "label": "Process Flush Plans",
      "advanced": true,
      "help": "Have Remnic ingest and clear OpenClaw's append-only flush-plan file. Disable when OpenClaw owns this lifecycle natively."
    },
    "qmdCollection": {
      "label": "QMD Collection",
      "advanced": true,
      "placeholder": "openclaw-engram"
    },
    "qmdMaxResults": {
      "label": "QMD Max Results",
      "advanced": true,
      "placeholder": "8"
    },
    "qmdColdTierEnabled": {
      "label": "Enable Cold QMD Tier",
      "advanced": true,
      "help": "When hot recall misses, query a secondary cold QMD collection before archive scan fallback"
    },
    "qmdColdCollection": {
      "label": "Cold QMD Collection",
      "advanced": true,
      "placeholder": "openclaw-engram-cold"
    },
    "qmdColdMaxResults": {
      "label": "Cold QMD Max Results",
      "advanced": true,
      "placeholder": "8"
    },
    "qmdTierMigrationEnabled": {
      "label": "Enable Tier Migration",
      "advanced": true,
      "help": "Enable value-aware hot/cold migration controls"
    },
    "qmdTierDemotionMinAgeDays": {
      "label": "Tier Demotion Min Age Days",
      "advanced": true,
      "placeholder": "14"
    },
    "qmdTierDemotionValueThreshold": {
      "label": "Tier Demotion Value Threshold",
      "advanced": true,
      "placeholder": "0.35"
    },
    "qmdTierPromotionValueThreshold": {
      "label": "Tier Promotion Value Threshold",
      "advanced": true,
      "placeholder": "0.7"
    },
    "qmdTierParityGraphEnabled": {
      "label": "Tier Parity Graph Checks",
      "advanced": true
    },
    "qmdTierParityHiMemEnabled": {
      "label": "Tier Parity HiMem Checks",
      "advanced": true
    },
    "qmdTierAutoBackfillEnabled": {
      "label": "Tier Auto Backfill",
      "advanced": true,
      "help": "Enable automated cold-tier backfill runs for parity repair"
    },
    "qmdSupportedVersion": {
      "label": "QMD Supported Version",
      "advanced": true,
      "placeholder": "2.5.3"
    },
    "qmdAutoUpgradeEnabled": {
      "label": "QMD Auto Upgrade",
      "advanced": true,
      "help": "Upgrade PATH/fallback QMD installs to the supported version; explicit qmdPath installs are skipped"
    },
    "qmdAutoUpgradeCheckIntervalMs": {
      "label": "QMD Auto Upgrade Interval",
      "advanced": true,
      "placeholder": "86400000"
    },
    "qmdChunkStrategy": {
      "label": "QMD Chunk Strategy",
      "advanced": true,
      "placeholder": "auto"
    },
    "qmdCandidateLimit": {
      "label": "QMD Candidate Limit",
      "advanced": true
    },
    "qmdQueryRerankEnabled": {
      "label": "QMD Query Rerank",
      "advanced": true
    },
    "qmdSearchStrategy": {
      "label": "QMD Search Strategy",
      "advanced": true,
      "placeholder": "hybrid",
      "help": "hybrid = lex+vec+hyde (default, best recall). lex-vec drops HyDE. lex = BM25-only (fastest). Lower tiers reduce CPU latency at the cost of recall."
    },
    "qmdSubprocessStrategy": {
      "label": "QMD Subprocess Strategy",
      "advanced": true,
      "placeholder": "query",
      "help": "query = qmd query with LLM expansion + rerank (default). search = BM25-only fallback, faster on huge collections but loses expansion/rerank."
    },
    "qmdDaemonTimeoutMs": {
      "label": "QMD Daemon Timeout (ms)",
      "advanced": true,
      "placeholder": "8000"
    },
    "qmdIndexName": {
      "label": "QMD Index Name",
      "advanced": true,
      "help": "Use a named QMD index when QMD 2.5+ supports --index. Changing this selects a different SQLite DB; keep it unset for existing default-index installs."
    },
    "qmdForceCpu": {
      "label": "QMD Force CPU",
      "advanced": true,
      "help": "Set QMD_FORCE_CPU=1 for QMD child processes"
    },
    "qmdGpuBackend": {
      "label": "QMD GPU Backend",
      "advanced": true,
      "placeholder": "metal"
    },
    "qmdEmbedParallelism": {
      "label": "QMD Embed Parallelism",
      "advanced": true,
      "placeholder": "4"
    },
    "qmdEmbedModel": {
      "label": "QMD Embed Model",
      "advanced": true
    },
    "qmdRerankModel": {
      "label": "QMD Rerank Model",
      "advanced": true
    },
    "qmdGenerateModel": {
      "label": "QMD Generate Model",
      "advanced": true
    },
    "embeddingFallbackEnabled": {
      "label": "Embedding Fallback",
      "help": "Use semantic embeddings when QMD is unavailable or no results are found"
    },
    "embeddingFallbackProvider": {
      "label": "Embedding Provider",
      "advanced": true,
      "placeholder": "auto"
    },
    "embeddingFallbackModel": {
      "label": "Embedding Model",
      "advanced": true,
      "placeholder": "(defaults to local LLM model)",
      "help": "Optional embedding model for semantic fallback. Use this when the local chat model and embedding model are different."
    },
    "qmdPath": {
      "label": "QMD Path",
      "advanced": true,
      "placeholder": "/opt/homebrew/bin/qmd",
      "help": "Optional absolute path to qmd binary for environments with unstable PATH/bun shims"
    },
    "memoryDir": {
      "label": "Memory Directory",
      "advanced": true,
      "placeholder": "~/.openclaw/workspace/memory/local"
    },
    "debug": {
      "label": "Debug Mode",
      "advanced": true
    },
    "identityEnabled": {
      "label": "Identity Reflections",
      "help": "Append self-reflections to workspace IDENTITY.md after each extraction"
    },
    "identityContinuityEnabled": {
      "label": "Identity Continuity",
      "help": "Enable identity continuity workflows (anchor, incidents, audits)"
    },
    "identityInjectionMode": {
      "label": "Identity Context Mode",
      "advanced": true,
      "placeholder": "recovery_only",
      "help": "When to add identity continuity context: recovery_only, minimal, or full"
    },
    "identityMaxInjectChars": {
      "label": "Identity Max Context Chars",
      "advanced": true,
      "placeholder": "1200"
    },
    "continuityIncidentLoggingEnabled": {
      "label": "Continuity Incident Logging",
      "advanced": true,
      "help": "When omitted, follows Identity Continuity enabled state"
    },
    "continuityAuditEnabled": {
      "label": "Continuity Audits",
      "advanced": true,
      "help": "Generate continuity audit artifacts"
    },
    "sessionObserverEnabled": {
      "label": "Session Observer",
      "advanced": true,
      "help": "Observe heartbeat growth and proactively trigger extraction when configured thresholds are crossed"
    },
    "sessionObserverDebounceMs": {
      "label": "Observer Debounce (ms)",
      "advanced": true,
      "placeholder": "120000"
    },
    "sessionObserverBands": {
      "label": "Observer Size Bands",
      "advanced": true,
      "help": "Array of {maxBytes, triggerDeltaBytes, triggerDeltaTokens} threshold objects"
    },
    "injectQuestions": {
      "label": "Inject Questions",
      "help": "Include the most relevant open question in generated memory context"
    },
    "commitmentDecayDays": {
      "label": "Commitment Decay (days)",
      "advanced": true,
      "placeholder": "90",
      "help": "Positive integer days before fulfilled/expired commitments are removed."
    },
    "workspaceDir": {
      "label": "Workspace Directory",
      "advanced": true,
      "placeholder": "~/.openclaw/workspace"
    },
    "accessTrackingEnabled": {
      "label": "Access Tracking",
      "help": "Track which memories are accessed most frequently"
    },
    "accessTrackingBufferMaxSize": {
      "label": "Access Buffer Size",
      "advanced": true,
      "placeholder": "100"
    },
    "recencyWeight": {
      "label": "Recency Weight",
      "advanced": true,
      "help": "How much to boost recent memories in search (0-1)",
      "placeholder": "0.2"
    },
    "boostAccessCount": {
      "label": "Boost Frequent Access",
      "help": "Rank frequently accessed memories higher in search"
    },
    "captureMode": {
      "label": "Capture Mode",
      "help": "Choose whether Engram stores only explicit notes, normal extraction, or both."
    },
    "agentAccessHttp": {
      "label": "Local HTTP Access",
      "help": "Enable a local authenticated HTTP API for external Engram clients"
    },
    "negativeExamplesEnabled": {
      "label": "Negative Examples",
      "help": "Track retrieved-but-not-useful memories and apply a small ranking penalty (optional)"
    },
    "negativeExamplesPenaltyPerHit": {
      "label": "Negative Penalty / Hit",
      "advanced": true,
      "placeholder": "0.05"
    },
    "negativeExamplesPenaltyCap": {
      "label": "Negative Penalty Cap",
      "advanced": true,
      "placeholder": "0.25"
    },
    "chunkingEnabled": {
      "label": "Enable Chunking",
      "help": "Automatically split long memories into overlapping chunks for better retrieval"
    },
    "chunkingTargetTokens": {
      "label": "Chunk Target Tokens",
      "advanced": true,
      "placeholder": "200"
    },
    "chunkingMinTokens": {
      "label": "Chunk Min Tokens",
      "advanced": true,
      "placeholder": "150"
    },
    "chunkingOverlapSentences": {
      "label": "Chunk Overlap Sentences",
      "advanced": true,
      "placeholder": "2"
    },
    "semanticChunkingEnabled": {
      "label": "Semantic Chunking",
      "help": "Use embedding-based topic detection for more coherent chunks (requires chunking enabled)"
    },
    "semanticChunkingConfig": {
      "label": "Semantic Chunking Config",
      "advanced": true,
      "help": "Override defaults for semantic chunking algorithm parameters"
    },
    "contradictionDetectionEnabled": {
      "label": "Contradiction Detection",
      "help": "Detect and resolve conflicting memories using LLM verification"
    },
    "contradictionSimilarityThreshold": {
      "label": "Contradiction Similarity Threshold",
      "advanced": true,
      "placeholder": "0.7"
    },
    "contradictionMinConfidence": {
      "label": "Contradiction Min Confidence",
      "advanced": true,
      "placeholder": "0.9"
    },
    "contradictionAutoResolve": {
      "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)"
    },
    "temporalSupersessionIncludeInRecall": {
      "label": "Include Superseded Facts In Recall",
      "advanced": true,
      "help": "If enabled, superseded facts still surface in recall (audit/history mode)."
    },
    "recallDirectAnswerEnabled": {
      "label": "Direct-Answer Retrieval Tier",
      "help": "Opt in to the direct-answer retrieval tier for validated high-trust queries before QMD (issue #518)."
    },
    "recallDisclosureEscalation": {
      "label": "Disclosure Auto-Escalation",
      "help": "Auto-promote default chunk recalls to section when top-K confidence is low (issue #677 PR 4/4). Set to 'auto' to enable; 'manual' (default) preserves pre-#677 behavior."
    },
    "recallDisclosureEscalationThreshold": {
      "label": "Disclosure Escalation Threshold",
      "advanced": true,
      "placeholder": "0.5",
      "help": "Top-K confidence (0-1) below which auto-escalation triggers. Only consulted when Disclosure Auto-Escalation is set to 'auto'."
    },
    "recallGraphEnabled": {
      "label": "Graph Retrieval (PPR)",
      "help": "Run Personalized PageRank on the retrieval graph and merge with QMD via MMR (issue #559)."
    },
    "recallGraphDamping": {
      "label": "Graph Recall Damping",
      "advanced": true,
      "placeholder": "0.85"
    },
    "recallGraphIterations": {
      "label": "Graph Recall Iterations",
      "advanced": true,
      "placeholder": "20"
    },
    "recallGraphTopK": {
      "label": "Graph Recall Top-K",
      "advanced": true,
      "placeholder": "50"
    },
    "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"
    },
    "threadingEnabled": {
      "label": "Conversation Threading",
      "help": "Group memories into conversation threads with auto-titles"
    },
    "threadingGapMinutes": {
      "label": "Thread Gap (minutes)",
      "advanced": true,
      "placeholder": "30"
    },
    "summarizationEnabled": {
      "label": "Memory Summarization",
      "help": "Compress old, low-importance memories into summaries"
    },
    "summarizationTriggerCount": {
      "label": "Summarization Trigger",
      "advanced": true,
      "placeholder": "1000"
    },
    "summarizationRecentToKeep": {
      "label": "Recent to Keep",
      "advanced": true,
      "placeholder": "300"
    },
    "summarizationImportanceThreshold": {
      "label": "Importance Threshold",
      "advanced": true,
      "placeholder": "0.3"
    },
    "topicExtractionEnabled": {
      "label": "Topic Extraction",
      "help": "Extract key topics from memory corpus"
    },
    "topicExtractionTopN": {
      "label": "Top N Topics",
      "advanced": true,
      "placeholder": "50"
    },
    "transcriptEnabled": {
      "label": "Enable Transcript Archive",
      "help": "Archive conversation transcripts for context preservation"
    },
    "transcriptRetentionDays": {
      "label": "Transcript Retention (days)",
      "advanced": true,
      "placeholder": "7"
    },
    "transcriptSkipChannelTypes": {
      "label": "Skip Channel Types",
      "advanced": true,
      "help": "Channel types to exclude from transcript logging (default: cron)"
    },
    "transcriptRecallHours": {
      "label": "Transcript Recall (hours)",
      "advanced": true,
      "placeholder": "12"
    },
    "maxTranscriptTurns": {
      "label": "Max Transcript Turns",
      "advanced": true,
      "placeholder": "50"
    },
    "maxTranscriptTokens": {
      "label": "Max Transcript Tokens",
      "advanced": true,
      "placeholder": "1000"
    },
    "checkpointEnabled": {
      "label": "Enable Checkpoints",
      "help": "Capture conversation checkpoints for resuming context"
    },
    "checkpointTurns": {
      "label": "Checkpoint Turn Interval",
      "advanced": true,
      "placeholder": "15"
    },
    "compactionResetEnabled": {
      "label": "Compaction Reset",
      "help": "Reset session after compaction and add BOOT.md recovery context",
      "advanced": true
    },
    "hourlySummariesEnabled": {
      "label": "Enable Hourly Summaries",
      "help": "Generate hourly summaries of conversation activity"
    },
    "summaryRecallHours": {
      "label": "Summary Recall (hours)",
      "advanced": true,
      "placeholder": "24"
    },
    "maxSummaryCount": {
      "label": "Max Summary Count",
      "advanced": true,
      "placeholder": "6"
    },
    "summaryModel": {
      "label": "Summary Model",
      "advanced": true,
      "placeholder": "(same as extraction model)"
    },
    "modelSource": {
      "label": "Model Source",
      "help": "Route LLM calls through the gateway's agent model chain instead of Engram's own config. Default for OpenClaw installs. When set to 'gateway', localLlm and openai settings are ignored."
    },
    "gatewayAgentId": {
      "label": "Gateway Agent ID",
      "advanced": true,
      "placeholder": "engram-llm",
      "help": "Agent persona ID from openclaw.json agents.list[] whose model chain to use. Leave empty to use global defaults."
    },
    "fastGatewayAgentId": {
      "label": "Fast Gateway Agent ID",
      "advanced": true,
      "placeholder": "engram-llm-fast",
      "help": "Agent persona ID for fast-tier ops. Leave empty to use the primary gatewayAgentId."
    },
    "taskModelChain": {
      "label": "Task Model Chain",
      "advanced": true,
      "help": "Optional primary/fallback gateway model chain for Remnic background tasks (extraction, consolidation, summarization). Overrides gatewayAgentId/defaults for these tasks only. Requires modelSource: 'gateway'."
    },
    "localLlmEnabled": {
      "label": "Enable Local LLM",
      "help": "Use local LLM (LM Studio, Ollama, etc.) for extraction and summaries. Falls back to OpenAI if unavailable."
    },
    "localLlmUrl": {
      "label": "Local LLM URL",
      "advanced": true,
      "placeholder": "http://localhost:1234/v1",
      "help": "OpenAI-compatible endpoint URL for local LLM"
    },
    "localLlmModel": {
      "label": "Local LLM Model",
      "advanced": true,
      "placeholder": "local-model",
      "help": "Model identifier for local LLM requests"
    },
    "localLlmApiKey": {
      "label": "Local LLM API Key",
      "advanced": true,
      "sensitive": true,
      "placeholder": "sk-...",
      "help": "Optional API key for authenticated OpenAI-compatible endpoints"
    },
    "localLlmHeaders": {
      "label": "Local LLM Headers",
      "advanced": true,
      "help": "Optional extra headers for provider-specific routing/auth"
    },
    "localLlmAuthHeader": {
      "label": "Send Auth Header",
      "advanced": true,
      "help": "When false, do not send Authorization header even if localLlmApiKey is set"
    },
    "localLlmFallback": {
      "label": "Local LLM Fallback",
      "advanced": true,
      "help": "Fall back to cloud OpenAI if local LLM fails or is unavailable"
    },
    "localLlmHomeDir": {
      "label": "Local LLM Home Dir",
      "advanced": true,
      "placeholder": "(auto: HOME / os.homedir)",
      "help": "Optional home directory override for LM Studio settings and local helper paths."
    },
    "localLmsCliPath": {
      "label": "LMS CLI Path",
      "advanced": true,
      "placeholder": "/path/to/lms",
      "help": "Optional absolute path to LMS CLI. Overrides auto-detection."
    },
    "localLmsBinDir": {
      "label": "LMS Bin Dir",
      "advanced": true,
      "placeholder": "/path/to/bin",
      "help": "Optional bin directory prepended to PATH for LMS CLI execution."
    },
    "localLlmMaxContext": {
      "label": "Local LLM Max Context",
      "advanced": true,
      "placeholder": "(auto-detected from model)",
      "help": "Override context window if your LLM server uses smaller default (e.g., 32768 for LM Studio default)"
    },
    "localLlmFastEnabled": {
      "label": "Fast LLM Tier",
      "help": "Use a separate smaller model for quick operations (rerank, entity summaries, compression guidelines)"
    },
    "localLlmFastModel": {
      "label": "Fast LLM Model",
      "placeholder": "qwen3.5-4b-mlx",
      "help": "Model ID for fast-tier operations. Must be loaded in LM Studio alongside the primary model."
    },
    "localLlmFastUrl": {
      "label": "Fast LLM URL",
      "advanced": true,
      "placeholder": "(defaults to localLlmUrl)",
      "help": "Endpoint for fast-tier model. When not set, inherits the primary localLlmUrl."
    },
    "localLlmFastTimeoutMs": {
      "label": "Fast LLM Timeout (ms)",
      "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."
    },
    "evalShadowModeEnabled": {
      "label": "Evaluation Shadow Mode",
      "advanced": true,
      "help": "Reserve shadow-mode measurement paths so future benchmark instrumentation can compare memory behavior without affecting live recall."
    },
    "benchmarkBaselineSnapshotsEnabled": {
      "label": "Benchmark Baseline Snapshots",
      "advanced": true,
      "help": "Enable versioned benchmark baseline snapshot artifacts for later PR delta reporting."
    },
    "benchmarkDeltaReporterEnabled": {
      "label": "Benchmark Delta Reporter",
      "advanced": true,
      "help": "Enable named-baseline delta reports that compare the current eval store against a stored benchmark baseline snapshot."
    },
    "evalStoreDir": {
      "label": "Evaluation Store Directory",
      "advanced": true,
      "placeholder": "{memoryDir}/state/evals",
      "help": "Override where benchmark packs and run summaries are stored."
    },
    "objectiveStateMemoryEnabled": {
      "label": "Objective-State Memory",
      "help": "Enable the objective-state memory foundation for normalized world and tool state snapshots."
    },
    "objectiveStateSnapshotWritesEnabled": {
      "label": "Objective-State Snapshot Writes",
      "advanced": true,
      "help": "Allow snapshot writers to persist objective-state records into the objective-state store."
    },
    "objectiveStateRecallEnabled": {
      "label": "Objective-State Recall",
      "advanced": true,
      "help": "Add recall-relevant objective-state snapshots to recall context."
    },
    "objectiveStateStoreDir": {
      "label": "Objective-State Store Directory",
      "advanced": true,
      "placeholder": "{memoryDir}/state/objective-state",
      "help": "Override where objective-state snapshots are stored."
    },
    "causalTrajectoryMemoryEnabled": {
      "label": "Causal Trajectory Memory",
      "help": "Enable the causal-trajectory memory foundation for typed goal-action-observation-outcome chains."
    },
    "causalTrajectoryStoreDir": {
      "label": "Causal Trajectory Store Directory",
      "advanced": true,
      "placeholder": "{memoryDir}/state/causal-trajectories",
      "help": "Override where causal-trajectory records are stored."
    },
    "causalTrajectoryRecallEnabled": {
      "label": "Causal Trajectory Recall",
      "advanced": true,
      "help": "Add recall-relevant causal trajectories to recall context."
    },
    "trustZonesEnabled": {
      "label": "Trust Zones",
      "help": "Enable the trust-zone memory foundation for quarantine, working, and trusted records."
    },
    "quarantinePromotionEnabled": {
      "label": "Quarantine Promotion",
      "advanced": true,
      "help": "Reserve future promotion flows from quarantine into higher-trust zones."
    },
    "trustZoneStoreDir": {
      "label": "Trust-Zone Store Directory",
      "advanced": true,
      "placeholder": "{memoryDir}/state/trust-zones",
      "help": "Override where trust-zone records are stored."
    },
    "trustZoneRecallEnabled": {
      "label": "Trust-Zone Recall",
      "advanced": true,
      "help": "Add recall-relevant working and trusted trust-zone records to recall context."
    },
    "memoryPoisoningDefenseEnabled": {
      "label": "Memory Poisoning Defense",
      "advanced": true,
      "help": "Enable provenance trust scoring in trust-zone status output as the first poisoning-defense signal."
    },
    "memoryRedTeamBenchEnabled": {
      "label": "Memory Red-Team Benchmarks",
      "advanced": true,
      "help": "Enable operator-facing red-team benchmark pack support and status accounting for poisoning-defense suites."
    },
    "harmonicRetrievalEnabled": {
      "label": "Harmonic Retrieval",
      "help": "Enable harmonic retrieval blending over abstraction nodes and cue anchors, including recall-section assembly and harmonic-search diagnostics."
    },
    "abstractionAnchorsEnabled": {
      "label": "Abstraction Anchors",
      "advanced": true,
      "help": "Enable typed cue-anchor indexing for abstraction nodes and expose it through cue-anchor status tooling."
    },
    "abstractionNodeStoreDir": {
      "label": "Abstraction-Node Store Directory",
      "advanced": true,
      "placeholder": "{memoryDir}/state/abstraction-nodes",
      "help": "Override where abstraction nodes are stored."
    },
    "verifiedRecallEnabled": {
      "label": "Verified Recall",
      "help": "Add recall-relevant memory boxes only when their cited source memories verify as non-archived episodes."
    },
    "semanticRulePromotionEnabled": {
      "label": "Semantic Rule Promotion",
      "advanced": true,
      "help": "Promote explicit IF/THEN rules from verified episodic memories into durable rule memories."
    },
    "semanticRuleVerificationEnabled": {
      "label": "Semantic Rule Verification",
      "advanced": true,
      "help": "Verify promoted semantic rules against their cited source episodes at recall time before surfacing them in recall."
    },
    "semanticConsolidationEnabled": {
      "label": "Semantic Consolidation",
      "advanced": true,
      "help": "Enable periodic semantic consolidation of similar memories."
    },
    "semanticConsolidationModel": {
      "label": "Semantic Consolidation Model",
      "advanced": true,
      "help": "LLM for consolidation synthesis: 'auto' (primary model), 'fast' (fast local model), or a specific model name."
    },
    "semanticConsolidationThreshold": {
      "label": "Semantic Consolidation Threshold",
      "advanced": true,
      "help": "Token overlap threshold (0-1) for grouping similar memories. 0.8=conservative, 0.6=aggressive."
    },
    "semanticConsolidationMinClusterSize": {
      "label": "Semantic Consolidation Min Cluster Size",
      "advanced": true,
      "help": "Minimum cluster size before consolidation triggers."
    },
    "semanticConsolidationExcludeCategories": {
      "label": "Semantic Consolidation Exclude Categories",
      "advanced": true,
      "help": "Memory categories excluded from semantic consolidation."
    },
    "semanticConsolidationIntervalHours": {
      "label": "Semantic Consolidation Interval (Hours)",
      "advanced": true,
      "help": "Hours between automatic consolidation runs (168 = weekly)."
    },
    "semanticConsolidationMaxPerRun": {
      "label": "Semantic Consolidation Max Per Run",
      "advanced": true,
      "help": "Max memories to consolidate per run to limit LLM cost."
    },
    "operatorAwareConsolidationEnabled": {
      "label": "Operator-Aware Consolidation",
      "advanced": true,
      "help": "Opt in to operator-aware consolidation instructions (default off). When enabled, the LLM returns structured {operator, output} JSON and we record SPLIT/MERGE/UPDATE on derived_via. When disabled (default), derived_via still populates via the cluster-shape heuristic."
    },
    "peerProfileReasonerEnabled": {
      "label": "Peer Profile Reasoner",
      "advanced": true,
      "help": "Enable the async peer profile reasoner (issue #679). Runs in the REM phase after semantic consolidation and updates per-peer profile.md files with provenance-tagged field updates derived from each peer's interaction log. Default off (opt-in)."
    },
    "peerProfileReasonerModel": {
      "label": "Peer Profile Reasoner Model",
      "advanced": true,
      "help": "Model identifier the peer profile reasoner records on telemetry. Dispatch still routes through the FallbackLlmClient used by semantic consolidation."
    },
    "peerProfileReasonerMinInteractions": {
      "label": "Peer Profile Reasoner Min Interactions",
      "advanced": true,
      "help": "Minimum new interaction-log entries a peer must accumulate since the previous reasoner run before being processed again. Set to 0 to consider every peer on every run."
    },
    "peerProfileReasonerMaxFieldsPerRun": {
      "label": "Peer Profile Reasoner Max Fields Per Run",
      "advanced": true,
      "help": "Hard cap on the total number of profile fields the reasoner will apply across all peers in a single run. Set to 0 to disable applying any fields."
    },
    "peerProfileRecallEnabled": {
      "label": "Peer Profile Recall",
      "advanced": true,
      "help": "When enabled, adds the active peer's profile fields to recall context as a '## Peer Profile' section. Requires the session peer ID to be registered. Default off."
    },
    "peerProfileRecallMaxFields": {
      "label": "Peer Profile Recall Max Fields",
      "advanced": true,
      "help": "Maximum number of peer profile fields to add per recall. Only the most-recently-updated N fields are included. Set to 0 to disable this feature."
    },
    "creationMemoryEnabled": {
      "label": "Creation Memory",
      "advanced": true,
      "help": "Enable creation-memory foundations, including the work-product ledger for explicit outputs agents create."
    },
    "memoryUtilityLearningEnabled": {
      "label": "Utility Learning",
      "advanced": true,
      "help": "Enable utility-learning telemetry storage so later slices can learn promotion and ranking weights from downstream outcomes."
    },
    "promotionByOutcomeEnabled": {
      "label": "Promotion By Outcome",
      "advanced": true,
      "help": "Enable outcome-aware promotion controls that will consume learned utility signals in later rollout slices."
    },
    "commitmentLedgerEnabled": {
      "label": "Commitment Ledger",
      "advanced": true,
      "help": "Enable the explicit commitment ledger for promises, follow-ups, deadlines, and unfinished obligations."
    },
    "commitmentLifecycleEnabled": {
      "label": "Commitment Lifecycle",
      "advanced": true,
      "help": "Enable fulfillment transitions, stale tracking, and resolved-entry cleanup for the commitment ledger."
    },
    "commitmentStaleDays": {
      "label": "Commitment Stale Days",
      "advanced": true,
      "help": "Days before an open commitment without a due date counts as stale."
    },
    "commitmentLedgerDir": {
      "label": "Commitment Ledger Directory",
      "advanced": true,
      "placeholder": "{memoryDir}/state/commitment-ledger",
      "help": "Override where commitment ledger entries are stored."
    },
    "resumeBundlesEnabled": {
      "label": "Resume Bundles",
      "advanced": true,
      "help": "Enable deterministic resume-bundle storage and explicit handoff bundle commands."
    },
    "resumeBundleDir": {
      "label": "Resume Bundle Directory",
      "advanced": true,
      "placeholder": "{memoryDir}/state/resume-bundles",
      "help": "Override where resume bundles are stored."
    },
    "workProductRecallEnabled": {
      "label": "Work-Product Recall",
      "advanced": true,
      "help": "Add recall-relevant work-product ledger entries to recall context and expose artifact-recovery search tooling."
    },
    "workProductLedgerDir": {
      "label": "Work-Product Ledger Directory",
      "advanced": true,
      "placeholder": "{memoryDir}/state/work-product-ledger",
      "help": "Override where work-product ledger entries are stored."
    },
    "actionGraphRecallEnabled": {
      "label": "Action Graph Recall",
      "help": "Write action-conditioned causal-stage edges from typed trajectory records into the causal graph."
    },
    "factDeduplicationEnabled": {
      "label": "Fact Deduplication",
      "help": "Prevent storing semantically identical facts using content hashing"
    },
    "semanticDedupEnabled": {
      "label": "Semantic Dedup (write-time)",
      "help": "Skip near-duplicate facts at write time by comparing embeddings to existing memories (issue #373)."
    },
    "semanticDedupThreshold": {
      "label": "Semantic Dedup Threshold",
      "advanced": true,
      "placeholder": "0.92"
    },
    "semanticDedupCandidates": {
      "label": "Semantic Dedup Candidates",
      "advanced": true,
      "placeholder": "5"
    },
    "factArchivalEnabled": {
      "label": "Fact Archival",
      "help": "Automatically archive old, low-importance, rarely-accessed facts during consolidation"
    },
    "factArchivalAgeDays": {
      "label": "Archival Age (days)",
      "advanced": true,
      "placeholder": "90"
    },
    "factArchivalMaxImportance": {
      "label": "Archival Max Importance",
      "advanced": true,
      "placeholder": "0.3"
    },
    "factArchivalMaxAccessCount": {
      "label": "Archival Max Access Count",
      "advanced": true,
      "placeholder": "2"
    },
    "factArchivalProtectedCategories": {
      "label": "Archival Protected Categories",
      "advanced": true,
      "help": "Categories that are never archived regardless of age or importance"
    },
    "lifecyclePolicyEnabled": {
      "label": "Lifecycle Policy Engine",
      "help": "Enable lifecycle scoring/promotions during consolidation (v8.3)"
    },
    "lifecycleFilterStaleEnabled": {
      "label": "Filter Stale Lifecycle Memories",
      "advanced": true,
      "help": "If enabled, retrieval may filter stale lifecycle memories (activated in PR20D)"
    },
    "lifecyclePromoteHeatThreshold": {
      "label": "Lifecycle Promote Heat Threshold",
      "advanced": true,
      "placeholder": "0.55"
    },
    "lifecycleStaleDecayThreshold": {
      "label": "Lifecycle Stale Decay Threshold",
      "advanced": true,
      "placeholder": "0.65"
    },
    "lifecycleArchiveDecayThreshold": {
      "label": "Lifecycle Archive Decay Threshold",
      "advanced": true,
      "placeholder": "0.85"
    },
    "lifecycleProtectedCategories": {
      "label": "Lifecycle Protected Categories",
      "advanced": true,
      "help": "Categories lifecycle policy should not auto-archive"
    },
    "lifecycleMetricsEnabled": {
      "label": "Lifecycle Metrics",
      "advanced": true,
      "help": "Write lifecycle metrics snapshots to state/lifecycle-metrics.json"
    },
    "proactiveExtractionEnabled": {
      "label": "Proactive Extraction",
      "help": "Enable proactive self-questioning extraction second-pass (v8.3, default off)"
    },
    "contextCompressionActionsEnabled": {
      "label": "Context Compression Actions",
      "help": "Enable context compression action tools and action telemetry (v8.3, default off)"
    },
    "compressionGuidelineLearningEnabled": {
      "label": "Compression Guideline Learning",
      "help": "Enable adaptive compression guideline learning from action outcomes (v8.3, default off)"
    },
    "compressionGuidelineSemanticRefinementEnabled": {
      "label": "Compression Semantic Refinement",
      "advanced": true,
      "help": "Enable optional semantic refinement after deterministic guideline generation (v8.11, default off)"
    },
    "compressionGuidelineSemanticTimeoutMs": {
      "label": "Compression Semantic Timeout (ms)",
      "advanced": true,
      "placeholder": "2500"
    },
    "maxProactiveQuestionsPerExtraction": {
      "label": "Max Proactive Questions / Extraction",
      "advanced": true,
      "placeholder": "2"
    },
    "proactiveExtractionTimeoutMs": {
      "label": "Proactive Extraction Timeout (ms)",
      "advanced": true,
      "placeholder": "2500"
    },
    "proactiveExtractionMaxTokens": {
      "label": "Proactive Extraction Max Tokens",
      "advanced": true,
      "placeholder": "900"
    },
    "extractionMaxOutputTokens": {
      "label": "Extraction Max Output Tokens",
      "advanced": true,
      "placeholder": "16384"
    },
    "proactiveExtractionCategoryAllowlist": {
      "label": "Proactive Category Allowlist",
      "advanced": true,
      "help": "Optional list of memory categories that proactive second-pass writes may emit"
    },
    "maxCompressionTokensPerHour": {
      "label": "Max Compression Tokens / Hour",
      "advanced": true,
      "placeholder": "1500"
    },
    "behaviorLoopAutoTuneEnabled": {
      "label": "Behavior Loop Auto-Tune",
      "help": "Enable bounded runtime policy auto-tuning from correction/preference signals (v8.15, default off)"
    },
    "behaviorLoopLearningWindowDays": {
      "label": "Behavior Learning Window (days)",
      "advanced": true,
      "placeholder": "14"
    },
    "behaviorLoopMinSignalCount": {
      "label": "Behavior Min Signal Count",
      "advanced": true,
      "placeholder": "10"
    },
    "behaviorLoopMaxDeltaPerCycle": {
      "label": "Behavior Max Delta / Cycle",
      "advanced": true,
      "placeholder": "0.1"
    },
    "behaviorLoopProtectedParams": {
      "label": "Behavior Protected Params",
      "advanced": true,
      "help": "Parameter keys that auto-tuning must never change"
    },
    "knowledgeIndexEnabled": {
      "label": "Knowledge Index",
      "help": "Inject a compact table of top entities into every recall"
    },
    "knowledgeIndexMaxEntities": {
      "label": "Knowledge Index Max Entities",
      "advanced": true,
      "placeholder": "40"
    },
    "knowledgeIndexMaxChars": {
      "label": "Knowledge Index Max Chars",
      "advanced": true,
      "placeholder": "4000"
    },
    "entityRetrievalEnabled": {
      "label": "Entity Retrieval",
      "help": "Inject direct-answer entity hints for entity questions and short follow-up queries"
    },
    "entityRetrievalMaxChars": {
      "label": "Entity Retrieval Max Chars",
      "advanced": true,
      "placeholder": "2400"
    },
    "entityRetrievalMaxHints": {
      "label": "Entity Retrieval Max Hints",
      "advanced": true,
      "placeholder": "2"
    },
    "entityRetrievalMaxSupportingFacts": {
      "label": "Entity Retrieval Max Supporting Facts",
      "advanced": true,
      "placeholder": "6"
    },
    "entityRetrievalMaxRelatedEntities": {
      "label": "Entity Retrieval Max Related Entities",
      "advanced": true,
      "placeholder": "3"
    },
    "entityRetrievalRecentTurns": {
      "label": "Entity Retrieval Recent Turns",
      "advanced": true,
      "placeholder": "6"
    },
    "entityRelationshipsEnabled": {
      "label": "Entity Relationships",
      "help": "Track entity-to-entity relationships during extraction"
    },
    "entityActivityLogEnabled": {
      "label": "Entity Activity Log",
      "help": "Log timestamped activity per entity"
    },
    "entityActivityLogMaxEntries": {
      "label": "Activity Log Max Entries",
      "advanced": true,
      "placeholder": "20"
    },
    "entityAliasesEnabled": {
      "label": "Entity Aliases",
      "help": "Store aliases per entity file"
    },
    "entitySummaryEnabled": {
      "label": "Entity Summaries",
      "help": "Generate LLM summaries for entities during consolidation"
    },
    "entitySynthesisMaxTokens": {
      "label": "Entity Synthesis Max Tokens",
      "advanced": true,
      "placeholder": "500",
      "help": "Max tokens used when refreshing an entity synthesis from its timeline."
    },
    "recallBudgetChars": {
      "label": "Recall Budget (Chars)",
      "advanced": true,
      "placeholder": "8000"
    },
    "recallPipeline": {
      "label": "Recall Pipeline",
      "advanced": true,
      "help": "Ordered section configuration for recall assembly and per-section limits"
    },
    "recallMmrEnabled": {
      "label": "Recall MMR (Diversity)",
      "advanced": true,
      "help": "Apply Maximal Marginal Relevance per-section so duplicate clusters cannot dominate the recall budget"
    },
    "recallMmrLambda": {
      "label": "MMR Lambda",
      "advanced": true,
      "placeholder": "0.7",
      "help": "1.0 = pure relevance, 0.0 = pure diversity. Default 0.7."
    },
    "recallMmrTopN": {
      "label": "MMR Top-N",
      "advanced": true,
      "placeholder": "40",
      "help": "Number of top candidates per section over which MMR is applied"
    },
    "recallReasoningTraceBoostEnabled": {
      "label": "Boost Reasoning Traces on Problem-Solving Queries",
      "advanced": true,
      "help": "Promote stored reasoning_trace memories to the top of recall results when the incoming query reads like a problem-solving ask. Default off; enable after benchmarking (issue #564)."
    }
  },
  "commandAliases": [
    {
      "name": "remnic",
      "kind": "runtime-slash",
      "cliCommand": "remnic"
    }
  ],
  "activation": {
    "onStartup": false,
    "onCommands": [
      "remnic"
    ],
    "onCapabilities": [
      "tool",
      "hook"
    ]
  }
}