Returns the user's home directory. Checks `HOME` (POSIX), then `USERPROFILE` (Windows), then `HOMEDRIVE`+`HOMEPATH` (legacy Windows). Panics if none

Poll the transcript pid file until either an in-flight async ingest clears or the time budget expires. Returns `true` when it is safe to spawn the syn

Check whether a process ID is alive without sending it a signal. On POSIX, `kill -0 <pid>` is the standard existence probe. On non-POSIX platforms th

Precompact hook: mine transcript convos and project files, then allow compaction. [`hook_ingest_transcript_sync`] handles the transcript convos synch

Session-start hook: create state directory, log the event, and pass through.

Spawn `mempalace mine <dir> --mode <mode>` in the background. Appends stdout and stderr to `hook.log`. Writes the child PID to [`PID_FILE_PROJECT`] s

Synchronously mine `MEMPAL_DIR` (precompact path — data must land before compaction). Transcript convos are ingested separately via `hook_ingest_tran

Block-mode stop: return `{"decision":"block"}` asking Claude to save via MCP.

Silent-mode stop: write diary directly, then emit a `systemMessage`.

Open the palace DB and insert a diary drawer row. Mirrors the SQL in `mcp/tools.rs::tool_diary_write`. Returns the entry ID on success, `None` on any

Return `true` if `path` looks like a `.claude/projects/` directory. Heuristic: at least one child directory whose name starts with `-` and which cont

Return `true` when `value` is a date-only ISO temporal (`YYYY-MM-DD`).

Return `true` when this provider's endpoint will send user content off the local machine or private network. URL-based heuristic shared by all three

Return `true` if a filename should be excluded from mining.

Scan `text` for new entity candidates and add high-confidence people to the registry. Uses [`detect_entities`] via a temporary file. Returns the name

Return `true` if `name` looks like a real person's name: has a space and at least two title-cased parts. Rejects single-token handles (`johndoe`), al

Numeric sort priority for a manifest filename: lower = higher priority. `pyproject.toml` (0) beats `package.json` (1) beats `Cargo.toml` (2) beats `g

Update `palace_path` in config.json if it still points to the legacy DB location.

Write all chunks for one conversation file into the palace.

Return `true` when `a` and `b` match as equal strings or as separator-bounded tokens of each other. Mirrors Python's `_name_matches` in `mempalace/mi

Collect people from stdin, looping until the user enters an empty line. For "combo" mode the context (personal vs work) is asked per person. Returns

Write the AAAK entities markdown and critical facts bootstrap files. Both files are written to the mempalace config directory.

Optionally scan `directory` for additional entity candidates and prompt the user. Skips if the user declines the scan prompt. Returns the augmented p

Seed the structured `EntityRegistry` (`entity_registry.json`) from onboarding data. Converts `PersonEntry` slices into [`RegistrySeedPerson`] records

Parse a `Cargo.toml` and return the `package.name` field, or `None` on error.

Parse a `package.json` and return the `"name"` field, or `None` on error.

Build the SQL and params for one direction of a `query_entity` call. When `as_of` is provided, the `valid_from`/`valid_to` comparison uses the tempor

Return the full wake-up context (L0 identity + L1 essential story). Equivalent to `layers::wake_up`. Pass `wing` to scope L1 to a single wing.

Refuse to write into `path` when it is itself a symbolic link. Defense-in-depth: a pre-placed symlink at an export target would redirect writes to wh

Resolve the project name for a slug directory by reading session JSONL files. Tries up to `MAX_SESSIONS_TO_TRY` session files (newest first). Falls b

Run the `closet-llm` command. Requires a configured LLM provider (via `llm_opts`). In `dry_run` mode, drawers are listed but the LLM is not called an

Print palace statistics: total drawers, per-wing and per-room counts, KG summary, and entity registry summary.

Run the diary-ingest command, filing new diary sections as drawers.

Print the instruction Markdown for `name` to stdout. Returns `Err` when `name` is not one of the available instruction names.

Backup the palace database, scan for inconsistencies, and rebuild the inverted word index. `confirm_truncation_ok` bypasses the truncation safety che

Run the MCP server: read JSON-RPC 2.0 requests from stdin, write responses to stdout.

Checkpoint the WAL and copy the palace database (plus sidecar files) to `.db.bak`.

Scan swept file content for new entity candidates and update the local registry. Called by [`run`] after a file sweep that added at least one drawer.

Resolve the output directory for one file and delegate to `split_file`. When `output_dir` is `None`, falls back to the file's parent directory and va

Print the mine prompt and return whether to proceed. With `auto_mine=true` returns `true` immediately without reading stdin. On EOF (non-interactive

Print the interactive proceed prompt and return whether the user accepted. In `--yes` / CI mode, always returns `true` without prompting. Called by [

Optionally refine `detected` using an LLM. Returns `detected` unchanged when LLM is disabled or unavailable. On LLM failure, batch errors are logged

Scan for index inconsistencies and report them. Reports two classes of problem: - Drawers with no `drawer_words` entries (content was never indexed).

Open a file for writing, refusing to follow a symlink at the target path. On POSIX, `O_NOFOLLOW` makes the open itself fail with `ELOOP` when the fin

`std::fs::write`-style wrapper that refuses to follow a symlink at `path`.

Return L3 keyword search results.

Score each row by how many query words appear in its content. Helper for [`search_closet_boost`]. Returns `(source_file, hit_count)` for rows that co

Re-rank candidates by BM25 score and return the top `n_results`.

Describe a source without extracting its content.

Extract start and end timestamps from a session's lines. Returns `Some((start_ts, end_ts))` where both are the same timestamp string when only one ti

Write one session chunk to disk and print a confirmation line. Returns the path of the written file. `session_idx` is 1-based for display.

`SQLite` expression for comparing a `valid_to`-style column with mixed temporal shapes. Widens date-only stored values to end-of-day (`T23:59:59Z`) s

`SQLite` expression for comparing a `valid_from`-style column with mixed temporal shapes. Widens date-only stored values (`length = 10`, `-` at posit

Return the comparable instant for a `valid_to`-style temporal value. Date-only inputs are widened to end-of-day so legacy date-only `valid_to` values

Insert one test drawer and index its words in an in-memory palace.

Serialize to a `serde_json::Value` for audit-trail persistence.

Split `value` into lowercased tokens bounded by `-`, `_`, `.` or `/`. Token boundaries prevent the "views" / "interviews" substring collision that a

Return the synthetic room identifier for a topic tunnel. The `topic:` prefix avoids collisions with literal folder-derived rooms of the same name and

BFS traversal from a starting room. Find connected rooms through shared wings. Returns `(results, truncated)` where `truncated` is `true` when the fu

Write a minimal valid Claude Code JSONL record to `path`. Uses the Claude Code native format: top-level `type` is `"user"` or `"assistant"`, with the

Index a drawer's words inside the `add_drawer` savepoint, releasing or rolling back the savepoint depending on whether indexing succeeds. Called by `a

Execute the INSERT OR IGNORE for a drawer inside the `add_drawer` savepoint. On SQL error, rolls back and releases the savepoint before returning `Err

Merge `names` into `category` inside `existing`. Dispatches to list-merge, dict-merge, or new-category helpers based on the current shape of the cate

Add names to an existing dict-format category as keys with `null` values. The dict shape (`{"Alice": "CODE"}`) is the dialect-registry format. New na

Append names to an existing list-format category, deduplicating case-insensitively. Original order of pre-existing entries is preserved; new names ar

Build a fresh deduplicated list from `names` for a new category. Input order is preserved; case-insensitive duplicates are dropped after the first oc

Replace `existing["topics_by_wing"][wing_key]` with a fresh deduplicated list from `topics`, preserving first-seen casing for each topic name. Called

Check whether an active triple already exists and return its ID if so. Called by `add_triple` to keep that function within the 70-line limit.

Upsert subject and object entities into the graph (INSERT OR IGNORE). Called by `add_triple` to keep that function within the 70-line limit.

Execute the final `INSERT INTO triples` for `add_triple`. Extracted to keep `add_triple` within the 70-line limit.

Called by `check_text` to parse relationship claims from `text` and compare them to the KG. For each "(subject, predicate, object)" claim, queries ou

Process one directory's `ReadDir` entries for corpus collection. Queues subdirectories onto `stack` and appends prose file content to `text`. Called

Read a prose file and append its content to `text` if it fits within the byte cap. Skips files without a recognized prose extension and files that wo

Parse a single directory's manifest files and append results to `found`. Called by [`collect_manifest_names`] to keep that function within the 70-lin

Create tunnels for every pair of wings that share `>= min_count` topics. Topics are compared case-insensitively; the first-observed casing (from whic

Accept all entities above `CONFIDENCE_THRESHOLD` without prompting. Called by [`confirm_entities`] when `yes=true`.

Prompt the user interactively for each detected entity above threshold. Called by [`confirm_entities`] when `yes=false`. Returns early without printi

Read the tunnel row back after upsert — the pair assertion half of the write.

UPDATE the tunnel if it exists, INSERT if it does not. The UPDATE-then-INSERT pattern (rather than INSERT OR REPLACE) preserves `created_at` on repea

Compile the current locale's `quote_pattern` regex on demand. Returns `None` when the locale JSON omits `quote_pattern` or the pattern fails to compi

Called by [`Dialect::decode`] to populate content fields of `decoded`. Parses a content line of the form `0:ENTITIES|topics|"quote"|emotions|FLAGS`.

Called by [`Dialect::decode`] to populate header fields of `decoded`. Expects a pipe-separated string of the form `WING|ROOM|DATE|STEM`. Missing segm

Delete one drawer and every row that references it. Without this, dropping a drawer would leave dangling `triples.source_drawer_id` and `explicit_tun

Run the five reference-cleanup statements that compose `dedup_delete_drawer`. Split out so the transaction wrapper can call a single fallible body an