POST JSON to `url` and return the parsed response body as a [`Value`]. Sets `Content-Type: application/json` and any `extra_headers`. Maps ureq trans

Return `true` if `source_file` chunk `chunk_index` is already in the palace. Callers use this to skip re-extraction of content that has not changed.

Layer 0: Identity text from `$XDG_DATA_HOME/mempalace/identity.txt`.

Move a single file, trying rename first, falling back to copy + delete. Rename is fast and atomic on the same filesystem. Copy + delete handles cross

Print the mine-convos progress header to stdout.

Extract entity names from a file for per-drawer metadata annotation. Called by `mine_process_file_one` to surface named entities (people and projects

Read the modification time of `filepath` as seconds since the Unix epoch. Called by `mine_process_file_one` to stamp all chunks from the same file wi

Wrap a path in single quotes for safe shell re-use in a resume hint. Single quotes in the path itself are escaped via `'"'"'`. Called by `mine_proces

Collect project names from stdin until the user enters an empty line. Returns up to `PROJECTS_LIMIT` project name strings.

Prompt the user to add auto-detected candidates to the people list. Shows each candidate's name and confidence, then asks (p)erson or (s)kip.

Scan `directory` for entity candidates not already in `known_people`. Returns only candidates whose confidence meets `DETECT_CONFIDENCE_MIN`.

Merge people and projects into the global known-entities registry. Returns the path written so the caller can display it to the user.

Return people whose names clash with common English words. Used to surface an ambiguity warning so the user understands the risk.

Write `aaak_entities.md` — the AAAK entity code registry.

Write `critical_facts.md` — the pre-palace facts bootstrap.

Open a file-backed turso database at `path`, apply the schema, and return `(Database, Connection)`. `repair::run` requires a real filesystem path bec

Parse a `go.mod` and return the last path segment of the `module` directive. For `module github.com/owner/my-project` this returns `"my-project"`.

Parse a `pyproject.toml` and return the project name. Checks `project.name` (PEP 621) first, then `tool.poetry.name` as a fallback.

Parse `--results` for `WakeUp`, rejecting zero as invalid.

Extract a Fact from a query row (columns: subject, predicate, object, `valid_from`, `valid_to`, confidence, `joined_name`).

Return aggregated palace statistics without printing anything. Callers such as `cli::status::run` and MCP tools use this instead of issuing direct da

Rebuild the full-text inverted word index from all drawer content. Wraps the full operation in a `BEGIN IMMEDIATE` transaction. Returns the number of

Collect `(name, entity_type)` pairs from all three categories of `detected`. Called by [`refine_entities`] to build the batching input.

Research an unknown word, optionally via a Wikipedia outbound request. By default this is **local-only**: checks the wiki cache and returns `"unknown

Run the compress command: compress drawers into AAAK dialect format.

Compress one drawer row and persist or preview it. Returns `(original_bytes, compressed_bytes, original_tokens, compressed_tokens)`. Token counts are

Run Pass 0 corpus-origin detection on the project directory. Tier 1 (heuristic) always runs. Tier 2 (LLM) runs only when `llm_opts` is enabled, a pro

Optionally upgrade a heuristic result with LLM-tier detection, then merge. Merges field-by-field: `likely_ai_dialogue`/`confidence` from heuristic; `

Discover entities from manifest files, git history, and Claude Code sessions. Returns the raw `ProjectInfo` list (for wing-name derivation) and the m

Run `git -C <cwd> <args>` and return stdout on success, or an empty string on error. No hard timeout is enforced: `std::process::Command` is synchron

Load dialect from an optional config file, or return an empty dialect.

Persist `lang` codes to the global `MempalaceConfig::entity_languages`. Called by [`run`] when `--lang` is provided. Failures are non-fatal: a full-d

Handle the `status` sub-command — opens the palace if it exists. `palace_override` takes priority over env vars and config, matching the `--palace` C

Write the L0/L1 (and optional L2/L3) wake-up layers to `out`. Extracted so tests can capture the rendered text. The caller is responsible for flushin

Scan `root` for projects (via manifests and git repos) and people (via git authors). Returns `(projects, people)` sorted by relevance — own projects

Handle the no-git-repo case: scan `root` directly for manifests. Called by [`scan`] to keep that function within the 70-line limit.

Compute person and project signal scores for `name` against `text` and `lines`. `pronoun_re` is the locale pronoun regex from `detect_entities_build_

Called by `score_entity_person` to keep that function within the 70-line limit. Scan `lines` for lines containing `name` and count how many have a pr

Score pre-lowercased text against pre-compiled regex markers. Callers must pass an already-lowercased string; this function does not lowercase intern

Fetch adjacent chunks from the same source file for context expansion. Returns drawers whose `source_file` matches `source_path` and whose `chunk_ind

Apply per-source-file closet rank boosts to `results` in place. Called by [`search_memories`] when [`closets::search_closet_boost`] returns a non-emp

Truncate `subject` so its byte length does not exceed `byte_cap`. Walks characters to avoid splitting a multi-byte UTF-8 sequence that byte-slicing w

Common stop words to exclude from topic extraction.

Sweep every `.jsonl` file in a directory tree into the palace. Individual file failures are logged to stderr and do not abort the sweep — a partial f

Query the set of drawer IDs already swept for each session in `session_ids`. Drawer IDs for swept messages follow the pattern `"sweep_{session_id}_{u

Translate a key using the active locale, with `{name}` variable interpolation. Key format: `"section.subkey"` (e.g. `"cli.mine_start"`) or a bare sub

Return the last [`QUERY_LEN_MAX`] chars of `text`.

Return the comparable instant for a `valid_from`-style temporal value. Date-only inputs are widened to the start of the day so a date-only `valid_fro

Check whether content is a near-duplicate of an existing drawer.

Check `text` for entity confusion and KG contradictions. Returns `issues` — a list of detected problems — or an empty list when clean. Each issue has

Delete a drawer and its inverted-index entries by ID.

Find rooms that bridge two wings, optionally filtering by wing names.

Return all explicit tunnel connections from a given wing and room.

Return the full wing → room → drawer-count taxonomy tree.

Return aggregate statistics about the palace graph (room count, tunnel count, etc.).

Get or set the hook behavior settings (`hook_silent_save`, `hook_desktop_toast`). Call with no arguments to read current settings. Pass one or both b

End-date a knowledge-graph triple by setting its `valid_to` field.

Return aggregate statistics for the knowledge graph (entity count, triple count, etc.).

Return rooms and their drawer counts, optionally filtered by wing.

Return all wings with their drawer counts.

Confirm palace database connectivity and return the current drawer count. On turso/SQLite there is no in-memory HNSW index to invalidate, so this too

Return a summary of all wings, rooms, and total drawer count.

BFS-traverse the palace graph from a starting room up to `max_hops` hops.

Compute topic tunnels involving a single wing only. Used by the miner to incrementally update tunnels for the wing that just finished mining without

Replace invalid UTF-8 byte sequences with the Unicode replacement character (U+FFFD). Valid UTF-8 input is returned unchanged. Adapters should apply

Validate that `content` is non-empty after the standard RFC-002 §1.4 transforms. Returns `Err(TransformationViolation(...))` if the content would be

Generate full wake-up text (L0 + L1).

Load the existing registry as a JSON object, or return an empty object. Returns an empty `Map` if the file is absent, unreadable, malformed, or not a

Route a single entity to the correct output bucket based on the LLM decision. Entities without a matching decision retain their original category. Ca

Return all available locale language codes. Codes are the canonical lowercase stems used in `get_entity_patterns` and `t`, e.g. `"en"`, `"de"`, `"pt-

Return on-demand L2 drawer recall scoped to `wing` and/or `room`.

Build the user prompt for one batch. Lists each candidate with its detected type and corpus context snippets. Called by [`refine_entities_batch`].

Return the largest byte index ≤ `index` that is a UTF‑8 char boundary in `s`. Slicing `text` by a raw byte offset is unsafe when the string contains

Return `(manifest_filename, project_name, dir)` triples for manifests within `repo_root`. Does not descend into nested git repositories. Results are

Called by `detect_entities` to keep that function within the 70-line limit. Sort each result list by descending confidence (people, projects) or desc

Count occurrences of each term (case-insensitive) in `combined`. Called by [`detect_origin_heuristic`] separately for unambiguous and ambiguous term

Called by `diary_ingest_file` when `--force` is set so `add_drawer` (INSERT OR IGNORE) refreshes existing diary content instead of silently no-op'ing

Called by `diary_ingest_file` to delete drawers for sections that no longer exist in the source file. Iterates the open range `current_count..previou

Count all rows in the `drawers` table without touching the word index. Returns `None` when the query fails (schema drift, closed connection). Callers

Keyword → emotion code signals for plain-text detection.

Returns the path to `entity_registry.json` in the mempalace config directory. Respects `MEMPALACE_DIR` and XDG conventions via [`config_dir`].

Resolve the registry path inside `dir`, mirroring `entity_registry_path()` under a `MEMPALACE_DIR` override.

Group drawer rows into a `BTreeMap<(wing, room), Vec<(filed_at, content)>>`.

Check whether a file has already been mined *and is unchanged* since it was last filed. Returns `false` (triggering a re-mine) when: - No drawer for

Return the modification time of a file as seconds since the Unix epoch. Returns `None` when the file cannot be stat-ed or the platform does not suppo

Return all git repository roots under `root` (including `root` itself if it is a repo). Nested repos (submodules, monorepo children) are discovered b

Keyword → flag signals for plain-text detection.

Merge one locale's entity section into the running accumulator.

Resolve a language code (case-insensitive) to its raw JSON string, if found.