internal/

Package app wires together the mnemos configuration, logger, and storage into a single App value shared across CLI commands.

Package browse lists the OKF tree by walking it on disk and annotating each file with the index metadata mnemos holds for it.

Package chunk turns a ParsedDoc into deterministic, line-anchored chunks.

Package cli defines the mnemos cobra command tree.

Package config defines the mnemos configuration schema, its built-in defaults, and the layered loader that merges those defaults with the user's home- and project-level TOML files.

Package embed turns text into dense sentence embeddings for semantic search.

Package eval implements the OKF held-out retrieval evaluation: it derives example-query/expected-document pairs from a bundle, builds a held-out copy of the corpus with those queries stripped from their host chunks, ingests the copy into an ephemeral database, runs each query through the Retriever, and computes doc-level retrieval metrics against a versioned baseline.

Package ingest implements the V0 ingestion pipeline: discover files, hash them, skip unchanged ones, parse, chunk, and write documents/chunks/links and an event in a single transaction per document.

Package mcp exposes the mnemos retrieval surface over the Model Context Protocol.

Package memory is the verb layer of mnemos: one place that owns the behavior behind every memory operation (search, read, context, list, remember, okfy, forget, move).

Package model holds the core value types shared across the ingestion pipeline: the source descriptor, the parsed-document representation, and the persistence aggregates (Document, Chunk, Link).

Package okf implements an Open Knowledge Format (OKF) v0.1 conformance validator.

Package parse turns raw file bytes into a normalized model.ParsedDoc.

Package search implements V0 retrieval over the SQLite FTS5 index.

Package security holds the guardrails that keep mnemos local-first and secret-free: the SecretScanner that screens captured content before it is written, and the path/exclude rules that bound what the agent can touch.

Package storage provides SQLite persistence for mnemos: opening the database with sane PRAGMAs and running embedded goose migrations.

Package testutil provides shared, dependency-light helpers for tests across the mnemos packages: a migrated temp database, file creation, a silent logger, and a working-directory switch.

Package version exposes build metadata stamped into the binary via -ldflags -X at build time (see the Makefile).