**ALWAYS CALL** when the user references "yesterday / last week / earlier / 刚才 / 上周" etc. Newest-first cross-file feed of recent memory entri

Newest-first capture rows without keyword filtering — used by current_context.

Unconditional catch-up: reduce every non-reduced ended/failed session. Called from the daily 23:55 safety-net. Covers ``ended`` rows whose as

Spawn a daemon thread that reduces the session. Fire-and-forget.

Resume capture.

Pick up any ``failed`` session rows whose ``next_retry_at`` has elapsed.

Reduce pending sessions, then classify each fresh event-daily entry.

Run the MCP server with the configured transport (for use inside the daemon).

Periodic check_cuts tick.

Periodic durable-fact classification for the active session. Every ``classifier.interval_minutes`` (min 5) checks for an active session and c

Once per local day at HH:MM, force-end open session + retry failed.

Incremental reducer tick for the active session. Every ``session.flush_minutes`` (min 5) checks for an active session and reduces any closed

Daemon task: every minute, materialise any closed windows.

Run the capture pipeline until cancelled. If ``cfg.event_driven`` is true, starts the watcher subprocess and routes events through the dispat

Run the server on stdio. Blocks until the client disconnects.

**ALWAYS CALL** before saying "I don't know" about something with a keyword in it. BM25 full-text search across every entry in COMPRESSED mem

BM25 + snippet search over capture S1 fields. The ``app_name`` filter is a case-insensitive substring match on the ``captures.app_name`` colu

BM25 + snippet search over the S1 FTS index. Returns a list of light-weight hits — `file_stem` is the handle to follow up with `read_recent_c

**ALWAYS CALL** (usually in parallel with `search`) when the user mentions a keyword they'd have typed or read on screen. Keyword search over

Start the OpenChronicle daemon.

Show daemon status + memory stats.

Stop the daemon.

Mark old entry superseded and append the new one. Returns new entry id.

Overwriting must not silently downgrade an existing file's mode. ``tempfile.mkstemp`` creates files at 0o600 — without explicit chmod the ren

Simulating a crash at the rename step must leave the file intact. A SIGKILL between ``write_text``'s first byte and last byte truncates the f

End-to-end: append → read returns the new entry, file isn't corrupted.

Direct unit test of the breadcrumb post-processor.

on_event → auto session start → force_end → row persisted → reducer run.

Time-based delete pass should also drop matching FTS rows.

Size-based eviction should also drop matching FTS rows.

Compaction must not overwrite entries appended while the LLM is running.

N threads appending to the same file must all land. Without the per-path lock, ``append_entry`` is read-modify-write: each thread reads the s

A supersede + an append on the same file must both land cleanly. Without the per-path lock, supersede's two-write read-modify-write can inter

Headlines newest-first, fulltext deduped by (app,window), timeline blocks ordered.

Returns a human-readable uptime when PID file exists.

Returns "stopped" when the daemon is not running.

Timestamp within 5 minutes → "healthy", "green".

Unparseable timestamps are handled gracefully.

PID exists but no last timestamp → "running (no captures yet)", "yellow".

Timestamp older than 5 minutes → "stale", "yellow".

(None, None) → "stopped", "red".

Offset-aware timestamps don't cause TypeError in subtraction.

Returns timestamp and app_name from the most recent buffer file.

Corrupted JSON returns the filename stem as timestamp, None for app.

No capture-buffer dir → (None, None).

A raised exception becomes 'ClassName: <first-line>' truncated to 80 chars.

When str(exc) is empty, the error label is just the class name.

OPENCHRONICLE_LLM_MOCK=1 short-circuits before any litellm import.

A normal litellm.completion return yields ok=True with a non-negative latency.

Error labels are capped so a verbose provider message can't blow up status output.

Stages with identical (model, base_url, api_key) only ping the network once. The default config gives every stage the same model, so a four-stage