> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Memory Health Runbook

> Daily operator checks and incident triage for MemU, contemplation, SIS, and RAG.

## Daily 5-Minute Check

<Steps>
  <Step title="Gateway baseline">
    ```bash theme={null}
    argent gateway status
    argent logs --follow --plain | rg --line-buffered "health: ok|ollama=|auth="
    ```
  </Step>

  <Step title="MemU extraction activity">
    ```bash theme={null}
    argent logs --follow --plain | rg --line-buffered "memu|Extraction complete|memu-extract|fallback episode stored"
    ```
  </Step>

  <Step title="Contemplation + SIS parse health">
    ```bash theme={null}
    argent logs --follow --plain | rg --line-buffered "contemplation|sis:|consolidation returned no patterns|no parseable JSON"
    ```
  </Step>

  <Step title="Auth routing sanity (memory providers)">
    ```bash theme={null}
    argent logs --follow --plain | rg --line-buffered "model-router|auth-failover|provider=ollama|selected profile"
    ```
  </Step>

  <Step title="RAG ingestion/retrieval health">
    ```bash theme={null}
    argent logs --follow --plain | rg --line-buffered "knowledge|library|ingest|collection|ACL|denied"
    ```
  </Step>
</Steps>

## Escalate Incident If

<Warning>
  * No successful MemU extraction for 30+ minutes during active chat.
  * SIS parse failures persist for 3+ consolidation windows.
</Warning>

## Common Critical Signatures

<AccordionGroup>
  <Accordion title="No API key found for provider 'ollama'">
    Check that Ollama is running and accessible. Verify MemU LLM provider configuration in `argent.json`.
  </Accordion>

  <Accordion title="Repeated 'sis: no parseable JSON'">
    Verify the selected provider/model for the SIS path. Check that the model supports structured output. Validate JSON contract and fallback parser behavior.
  </Accordion>

  <Accordion title="Prolonged absence of MemU extraction activity">
    During active use, MemU should be extracting regularly. Check gateway logs for errors in the memory extraction pipeline.
  </Accordion>
</AccordionGroup>

## Compatibility Warnings (Usually Non-Blocking)

<Note>
  These indicate compatibility mode, not immediate outage:

  * `Legacy dashboard SQLite modules are quarantined...`
  * `Using PostgreSQL compatibility mode for memory inspector.`
</Note>