Module store 

Structs

ImportRun

What one import run knows: each notes file it has touched, read from disk once and kept in step with what the run has stored since, in a dry run too. That is what makes the lines of one run be judged against each other, and a dry run report what the real run then does.

ImportedLine

import_line_in’s answer for one line.

MemoryDescriptor

Bounded search result: descriptor + snippet, NEVER the full body (full content requires an exact fetch_exact_in).

MemoryProvenance

Provenance of a memory record (spec §9.5).

MemoryQuery

MemoryRecord

NewMemoryRecord

Input for store_record_in — explicit provenance, sensitivity, and retention (spec §9.5: nothing is stored with implicit metadata).

ProjectMemoryQuery

Project-scoped search query. Limits clamp to the hard caps.

ProjectScope

Host-resolved project identity: the canonical workspace root, digested into a stable scope key. The HOST constructs this from trusted execution context — it is never accepted solely from model-authored arguments.

Enums

ImportOutcome

What import_line_in did with one line.

ImportTarget

Where import_line_in files a line.

MemoryError

MemoryRetention

Retention class of a memory record (consumed by spec §9.7 retention).

MemorySensitivity

Sensitivity class of a memory record (spec §9.5). Enforcement at the model-visibility boundary lives in the memory tools: Secret bodies are never returned to model context.

Constants

DEFAULT_LIMIT

Default per-query record cap.

DEFAULT_SEARCH_LIMIT

Default search result count.

DEFAULT_SNIPPET_BYTES

Default snippet bytes per descriptor.

MAX_CONTENT_BYTES

Maximum content length per record (UTF-8 byte length).

MAX_SEARCH_LIMIT

Hard cap on search results per call.

MAX_SNIPPET_BYTES

Hard cap on snippet bytes per descriptor.

Functions

append

Append one record. Validates namespace, content size. One line is one write to a file opened for append, and the file is synced before this returns (see append_jsonl_line).

append_to

fetch_exact_in

Fetch exact record ids within a project scope. EVERY id must resolve in this scope or the whole call fails closed with MemoryError::NotFound — other projects’ ids are indistinguishable from unknown ids.

forget_in

Tombstone one record in a project scope (append-only forget). Fails closed with MemoryError::NotFound for unknown, already-tombstoned, or other-project ids.

import_line_in

Import one JSONL line of another store’s notes into the plain-file store under base: a note (a MemoryRecord line) or a tombstone line ({"tombstone":"<id>","timestamp_ms":…}).

list_namespaces

List existing namespaces under the memory dir.

memory_dir

Path to the memory directory under base. Caller creates dirs lazily.

memory_dir_in

Memory directory under an explicit base (test/tool seam).

new_record

Build a record with now_ms() timestamp.

now_ms

Current Unix epoch in milliseconds.

open_lock_file

Open (creating it, mode 0600, never through a symlink) a lock file. Read and write access: Windows locks only a handle that has one of them. The folder is not created. Public for synaps memory import-notes, whose one lock for a whole run is opened as a notes file’s lock is.

project_notes_file

The notes file of the project with this key under base: where a save, a forget and an import of that project’s notes write. Only the path: nothing is created, and the key is not checked.

query

Query records in a namespace, applying filters, returning most-recent-first up to limit.

query_in

search_project_in

Project-scoped bounded search: descriptors + snippets, most recent first, hard-capped result count and snippet bytes.

store_record_in

Store one record in a project scope: assigns a stable mem-<uuid> id, binds the scope key, and appends to the project namespace.