Group commits by identity: two commits are the same person when they share a name OR email. Display name is the most-frequent name variant that `look

Remove duplicates from a list while preserving first-occurrence order.

Detect the "hall" — the top-level subdirectory within the project containing the file. Hall is the second-level grouping between wing (the whole proj

Detect rooms from the folder structure of a project directory.

Split diary text on `## ` H2 headers. Returns a list of `(header_line, body)` pairs. If the file has no `## ` headers the entire text is returned as

Build a `WikiCacheEntry` with the common fields pre-filled. All four classification paths in [`entity_registry_wikipedia_classify`] produce the same

Build a `WikiCacheEntry` representing a network failure or parse error. Called by [`entity_registry_wikipedia_lookup`] for any non-404 error path.

Export palace drawers to `output_dir`, one markdown file per wing/room. When `wing` is `Some`, only drawers in that wing are exported. When `dry_run`

Read one JSONL session file and return the `cwd` field from the first record that has one. Returns `None` if the file cannot be opened, has no parsab

Extract known person names from a search query string. Uses word-boundary regex matching. Ambiguous names are only included when context patterns con

Normalise Claude Code message content to a plain string. User messages are plain strings; assistant messages are a list of content blocks (`text`, `t

Build a sanitized JSON-RPC response from a raw tool dispatch result. Sanitize: only expose errors that tools explicitly mark as public. All other err

Count human messages in a JSONL transcript, skipping command-messages.

Synchronously run `mempalace mine <transcript_parent> --mode convos`. Used by the precompact hook so the transcript ingest finishes BEFORE the harnes

Parse and sanitize hook input from the stdin JSON payload.

Read the last-save message count from the session state file.

Mark a relationship as ended (set `valid_to`). Invalidate (end-date) matching triples and return the date that was stored.

Return `true` if every byte in `s` is an ASCII hex digit (`0-9`, `a-f`, `A-F`). Empty strings return `false`. Used to validate SHA strings so that ma

Build a parenthetical filter label for the layer2 empty message.

Layer 3: Deep keyword search across the full palace. Delegates to the inverted-index search (`palace::search::search_memories`) and formats the resul

Read a file's content, falling back to lossy UTF-8 on binary files. Returns `None` if the file is unreadable or too short to be useful.

Reconstruct the user's `mempalace mine` invocation from `opts` and `project_dir`, suitable for printing in the Ctrl-C resume hint. Only non-default f

Normalize line endings to `\n` only. Converts CRLF (`\r\n`) and bare CR (`\r`) to LF (`\n`). Adapters should apply this early so downstream code can

Normalize a wing slug: trim whitespace, then apply the canonical slug rule. Callers that filter by wing name must normalize before querying so that "

Show the default wings for the selected mode and allow the user to override. The user may accept the defaults (enter) or type comma-separated names.

Print a yes/no prompt and return true for yes, false for no. The default answer is used when the user presses enter without input.

Parse one JSONL record into a `SweepMessage`, or `None` if not applicable. Non-message record types (progress, file-history-snapshot, system, queue-o

Pretty-print a `SyncReport` to stdout, matching the Python CLI banner shape.

Query all facts for a given subject and predicate across all object entities. Returns every triple (active and expired) where the subject entity matc

Add `count` minimal drawers to the connection, bypassing the normal `add_drawer` validation so tests can control the exact row count easily.

Returns the path to the global known-entities registry file. Resolves via `config_dir()`, which respects `MEMPALACE_DIR` and XDG conventions.

Resolve the `/v1/chat/completions` URL from the raw endpoint string. Handles endpoints supplied with or without the `/v1` suffix and with or without

Run the `sweep` subcommand. Sweeps a single `.jsonl` file or every `.jsonl` in a directory tree, inserting one drawer per user/assistant message that

Run the `dedup` command. Reports stats whether or not `dry_run` is set. In dry-run mode no drawers are deleted.

Sum the byte sizes of every file in `files`, skipping those whose metadata cannot be read. Called by [`run`] to compute the size label shown in the i

Parse a JSON-RPC request from a trimmed line of text. Returns `Ok(Value)` on success, or `Err(Value)` containing a JSON-RPC parse-error response read

Build an [`LlmProvider`] from `opts` and probe its availability. Returns `None` when the provider is disabled, unreachable, or declined by the privac

Serialize `response` and write it as a newline-terminated frame to `stdout`.

Sanitize a string for use as a path component. Replaces `/`, `\`, `:`, `*`, `?`, `"`, `<`, `>`, `|`, and control characters with underscores to produ

Score project-related signals for `escaped` against `text`: build/deploy verbs and versioned references.

Return a multiplicative closet rank-boost per source file. Queries the `compressed` table for entries whose `source_file` is in `source_paths` and wh

Collect unique, non-empty source paths from `results`. Called by [`search_memories`] to assemble the path list for [`closets::search_closet_boost`].

Collect `.txt` file paths from the top level of `directory`. When `respect_gitignore` is `true`, files excluded by `.gitignore` rules are omitted (sa

Split `text` into segments for memory extraction.

Remove ASCII control characters except horizontal tab (`\t`) and newline (`\n`). All non-ASCII bytes are preserved so multi-byte UTF-8 sequences are

Returns a human-readable summary of the registry contents.

Build the deterministic drawer ID for a swept message. Uses the full `session_id` (not a prefix) to avoid cross-session collision risk when session i

Resolve a dotted-path key (`"section.subkey"` or bare `"subkey"`) against the string tables for the given locale. Returns `None` when the locale or k

Return a compiled English pronoun regex for use in tests that call `score_entity` directly. Production code builds this via `detect_entities_build_pr

Confirm a previously researched word as a specific entity type. When `entity_type` is `"person"`, the word is added to the people registry with `CONF

Create an explicit (agent-annotated) tunnel linking two palace locations.

Fetch a single drawer by ID, returning its full content and metadata.

Return all knowledge-graph facts sorted by validity date, optionally filtered by entity.

Return all explicit tunnels, optionally filtered to those involving a specific wing.

Acknowledge the latest silent-mode checkpoint written by the stop hook. Reads and deletes `hook_state/last_checkpoint`. Returns message count and tim

Look up a word in the entity registry; optionally research it via Wikipedia. Checks the local registry first via [`EntityRegistry::lookup`]. Only que

Validate that `record` satisfies all required fields declared in `schema` (RFC-002 §5.2). Returns `Err(SchemaConformance(...))` naming the first abse

Build a minimal valid Claude Code assistant record with a text block.

Return a sorted list of all registered adapter names.

Build a word-boundary-aware regex string for a brand term. Attaches `\b` only on edges where the term itself starts or ends with a word character (al

Compute the canonical tunnel ID from two endpoints. Tunnels are undirected — sort the two endpoint strings before hashing so `canonical_tunnel_id(A,

Check `text` for entity confusion and KG contradictions. Returns an empty vec when no issues are detected. The checker is deliberately conservative:

Called by `check_text_entity_confusion` to build a canonical dedup key for a name pair. Normalises order so (a, b) and (b, a) produce the same key, p

Drain AI response lines from `lines` starting at `start_index`. Collects non-empty lines until a new user turn (`>`) or separator (`---`) is found.

Return up to [`MAX_CONTEXT_SNIPPETS`] trimmed lines from `corpus_lines` containing `name`. Matching is case-insensitive. Called by [`build_user_promp

Extract (role, text) pairs from a message list and return a transcript. Accepts both `"role"` (API format) and `"sender"` (privacy export) as the aut

Path to the global config file.

Print a single `[person|project] "<name>" Accept? [Y/n]` prompt and read the response. Returns `true` if the user accepts (blank line, `y`, or `yes`)

Return the number of chunks already filed for `source_file`. Adapters use this to detect partially-ingested sources before deciding whether to re-ing

Best-effort project name from a slug when no session has a readable `cwd`. The slug is lossy (`/` and `-` both map to `-`). The last non-empty segmen

Delete an explicit tunnel by ID. Returns `true` if a row was deleted.

Detect emotions from plain text using keyword signals.

Called by `detect_entities` to build the pronoun proximity regex from locale patterns. Joins all pronoun patterns from `EntityPatterns` into a single

Called by `detect_entities` to load and concatenate file content. Reads up to `files_max` files from `file_paths`, truncating each at 5 000 bytes on

Detect importance flags from plain text using keyword signals.

Disambiguate memory type using sentiment and resolution.

Pull the first JSON object out of a possibly-messy LLM response. Attempts straight parse first; falls back to a balanced-brace scanner that finds the

Scan `text` for the outermost `{...}` block using brace-depth counting. No recursion — uses a `usize` depth counter. Called by [`extract_json_block`]

Extract only prose lines (skip code blocks and code-like lines).

Extract a subject from the first meaningful user prompt.

Follow explicit tunnels from a room — returns connections to linked rooms. Optionally fetches a short preview of the drawer at the connected end when

Return a regex pattern from the active locale's `regex` section. Falls back to English when the key is absent in the current locale. Returns `None` i

Validate `tools/call` params and extract `(tool_name, tool_args)`. Returns `Ok((name, args))` when the params are well-formed, or `Err(response)` wit

Return `true` if `path` contains a `.git` directory or file (bare repo marker).

Return `true` if the config has `hook_silent_save = true` (the default).

Background-mine `MEMPAL_DIR` (project files) if set. Transcript convos are ingested separately via `hook_ingest_transcript` in the hook handlers. Kee

Write a diary checkpoint for `session_id` to the palace DB. Returns `(message_count, themes)` on success, `(0, [])` on failure. Opens the DB using th

Write the hook response JSON to stdout. Hooks communicate back to the harness via a single JSON object on stdout. Using `println!` ensures the output