Create an in-memory turso database with the full schema applied. Returns (Database, Connection) tuple to keep the Database alive for the test lifetime

Collect all rows from a query into a Vec.

Wraps the three-line test setup (tempdir, `async_with_vars`, `test_conn`) so callers only express what is under test. The connection is passed by val

Extract a string argument from the tool args JSON object. Returns an empty string when the key is absent or the value is not a string.

Add a drawer and index its words. Returns `true` when the drawer was inserted, `false` when a drawer with the same `id` already exists (idempotent —

Create a fresh registry backed by a temporary directory.

Return the canonical root for `x`, inserting `x` as its own root on first access. Path compression is applied so repeated calls are nearly O(1).

Return merged entity detection patterns for the requested language codes. Language codes are matched case-insensitively (e.g., `"PT-BR"` or `"pt-br"`

Dispatch a tool call by name and return the JSON result.

Validate a wing/room/entity name. Returns `Some(error_json)` if invalid. Validates and trims `value`. Returns `Ok(trimmed)` on success, or `Err(err

Merge `entities_by_category` into the global known-entities registry. - List-format categories: union case-insensitively, original order preserved. -

Append a timestamped line to `hook.log` in `state_dir`.

Seed the registry from onboarding data and persist to disk. Clears existing `people` and `projects`; ambiguous flags are rebuilt from the new people

Validate request shape and dispatch to `handle_request_dispatch`. Returns `None` for notifications (no response required per JSON-RPC 2.0).

Remove system tags, hook output, and Claude Code UI chrome from a message. Applied per message (never across boundaries) so a dangling open tag in on

Search the palace using BM25-ranked inverted-index search. Two-pass approach: the first pass selects up to `n_results × BM25_OVERFETCH` candidates by

Returns the mempalace data directory. Resolution order: 1. `MEMPALACE_DIR` env var — explicit user, container, or test override. 2. `MEMPAL_DIR` env

Validate an optional name filter. Returns `Ok(None)` if the value is empty/whitespace-only, `Ok(Some(trimmed))` if valid, or `Err(error_json)` if the

Append a diary entry for an agent in its personal wing. When `wing` is supplied it is used directly (after sanitization); otherwise the wing is deriv

Try to parse Claude.ai JSON export into transcript text. Accepts three formats: - JSON array of message objects (`[{"role":…,"content":…}]`) - Object

Add a relationship triple. Auto-creates entities if they don't exist. Returns the triple ID.

Open the palace DB, ensuring schema exists. Returns `(db, connection, path)`. `palace_override` takes priority over `MEMPALACE_PALACE_PATH` and the c

Compress plain text into AAAK Dialect format.

Mine a project directory into the palace.

Normalize a file to transcript format. Detects format automatically and converts to `> user\nresponse\n\n` format.

Validate an ISO-8601 date or canonical UTC datetime string for KG temporal fields. Accepts `None` and the empty string as pass-through values so call

Expand a leading `~` to the user's home directory. Resolves the home directory by trying `HOME`, then `USERPROFILE`, then `HOMEDRIVE` + `HOMEPATH` (W

Extract user-message text from a single JSONL line; return `None` to skip. Handles both Claude Code (`message.role == "user"`) and Codex CLI (`type =

Print a prompt to stdout and read one trimmed line from `reader`. When `default` is `Some("")` the prompt shows nothing extra; when `default` is `Som

Generic core of `run_read_line` — accepts any `AsyncBufRead` so tests can drive the algorithm with a `Cursor` rather than a real stdin handle.

Bind a random port, accept exactly one connection, and respond with `body` as JSON. Returns the port so callers can build an endpoint URL. The spawne

Extract memories from text, classifying into 5 types: decision, preference, milestone, problem, emotional.

Convert [(role, text), ...] to transcript format with > markers.

Mine all conversation files in `directory`, filing chunks as drawers in the palace. Resolves the wing name, walks for eligible files, and delegates p

Load project config from `project_dir`, trying config file names in precedence order: `mempalace.yaml`, `mempalace.yml`, `mempal.yaml`, `mempal.yml`.

Regenerate `compressed` entries for drawers using a configured LLM. Optionally filters to a single `wing`. When `sample > 0`, only the first `sample`

Insert a new drawer into the palace, computing a deterministic SHA256-based ID.

Create (or update) an explicit tunnel between two palace locations. Tunnels are symmetric: calling with (A, B) and (B, A) both resolve to the same ca

List explicit tunnels, optionally filtered to those involving a given wing.

Look up a word and return its entity classification. Checks people registry first, then projects, then the wiki cache. Context is used to disambiguat

Build a test file containing `n_sessions` Claude Code session blocks, each with at least 12 content lines so the 10-line minimum is satisfied.

Resolve the palace database path, checking env vars in priority order. Resolution order: 1. `MEMPALACE_PALACE_PATH` — primary override. 2. `MEMPAL_PA

Add a subject–predicate–object triple to the knowledge graph.

Acquire an exclusive mine lock in `lock_dir`. Creates `lock_dir/mine.lock` atomically via `O_CREAT|O_EXCL` semantics. Returns `Err` immediately if th

Accept or interactively confirm detected entities. - `yes=true`: all entities with `confidence >= CONFIDENCE_THRESHOLD` are accepted without promptin

Layer 2: On-demand retrieval filtered by wing and/or room. Returns the most recent `results` drawers matching the given filters, formatted as a compa

Migrate from `~/.mempalace` to `$XDG_DATA_HOME/mempalace` if needed. Idempotent: returns immediately if already migrated, legacy dir absent, or eithe

Normalize a directory name into a wing slug. Lowercases the name and replaces spaces and hyphens with underscores. This is the single canonical rule

Validate a knowledge-graph entity value (subject or object). More permissive than `sanitize_name` — allows punctuation such as commas, colons, and pa

Scan a project directory for all readable files.

Insert or replace closet content for a single drawer in the `compressed` table. Called after LLM-driven or regex-driven closet generation for a drawe

Write `lines` to a temp file named `name` in `dir` and return the path.

Validate confidence and ISO temporal fields on a `TripleParams`. Both `valid_from` and `valid_to` are validated via [`crate::config::sanitize_iso_tem

Called by `check_text` to flatten the registry JSON into a set of entity names. Supports list-format (`["Alice", "Bob"]`) and dict-format (`{"Alice":

Scan files and detect entity candidates using the specified locale languages. Language codes are BCP 47 tags (e.g., `"en"`, `"de"`, `"pt-br"`). Stopw

Extract capitalized-word candidates from `text`, filtered by stop words and a minimum frequency of 3 occurrences. Returns a map of candidate name to

Ingest all diary files from `diary_dir` into the palace. Only files named `YYYY-MM-DD*.md` are processed. New sections discovered since the last run

Merge two [`DetectedDict`] values. Primary entries win on name conflict (case-insensitive). When `drop_uncertain` is `true`, the secondary's uncertai

Query all relationships for an entity.

Called by `score_entity_person` to apply locale-specific verb, dialogue, and direct-address signals. Each template substitutes `{name}` with `escaped

Update an existing drawer's content and/or location (wing/room). Recomputes the deterministic SHA256 ID after any change to keep it consistent with `

Build a minimal valid Claude Code user record as a JSON string.

Called by `check_text_kg_contradictions` to evaluate one claim against retrieved KG facts. Fires `relationship_mismatch` when the KG records a differ

One user turn (>) + the full AI response that follows = one or more chunks. Each line is whitespace-trimmed and empty lines are dropped; the remainin

Confidence that this is a real project. - `0.99` — user has commits (`is_mine`) - `0.7` — git repo with at least one commit by anyone (`has_git && t

Mark a researched word as confirmed and optionally promote it to the people registry. If `entity_type` is `"person"`, the word is added to `people` w

Compare the current diary file against its cursor entry and decide how much work to do. Strict mode (preferred): if a `content_hash` was recorded, on

Generate a stable, unique drawer ID for a diary section. Format: `diary-{wing_prefix}-{identity_hash}-{date}-{index}`. The 20-char sanitized prefix k

Normalize an entity name to an ID: lowercase, spaces→underscores, strip apostrophes.

Classify a Wikipedia REST API JSON response into a `WikiCacheEntry`. Checks `page_type` for disambiguation pages, then `extract` text for name and pl

Render one assistant message content block as a plain string. Called by `flatten_content` for each element of an array-typed message. All block types

Collect `mempalace mine` project targets from `MEMPAL_DIR`. `MEMPAL_DIR` (when set, valid, and free of `..` traversal segments) contributes a `Projec

Parse a JSON string literal into a `serde_json::Value`. Reduces boilerplate across tests that build JSON fixtures inline.

Split mega-files in a directory into per-session files.

Seed a single "Alice knows Bob" triple for reuse across tests.

Read the most recent diary entries for an agent, newest first. When `wing` is supplied the query is scoped to that wing AND to the requesting agent (

Full-text search the palace, returning ranked drawer results.

Try to parse Claude Code JSONL format into transcript text. Each line is a JSON object with `"type"` (`"human"` or `"user"` for the human turn, `"ass

Append a write-operation entry to `config_dir()/wal/write_log.jsonl`. The data directory is `$XDG_DATA_HOME/mempalace` by default, or the value of `M

Apply LLM `decisions` to `detected`, routing each entity to its new category. Returns `(refined_dict, reclassified_count, dropped_count)`. Entities w

Split content into drawer-sized chunks, breaking at paragraph/line boundaries.

Classify one drawer by inspecting its source-file metadata. When `project_roots` is empty the caller is scoping the run via `--wing` alone (the `run`

Walk `dir` for prose files (`.md`, `.txt`, `.rst`) and return concatenated text. Caps output at [`MAX_CORPUS_BYTES`] and limits recursion via [`CORPU

Build an [`LlmProvider`] by name. Valid provider names: `"ollama"`, `"openai-compat"`, `"anthropic"`. Returns `Err(Error::Llm)` for unknown names.

Index the words in a drawer's content into the `drawer_words` table.

Generate AAAK entity codes for each person: first 3 letters uppercase. Collision is resolved by extending to 4 characters.

Called by `regenerate_closets_process_drawer` to format `ClosetOutput` into stored text. Produces pipe-joined topics on one line, one quote per line,