MamboMeme
MamboMeme is a local ranked-search application for meme images and quotes. Rust owns ingestion and the terminal interface; Python owns index construction, ranked retrieval, the long-lived worker, and evaluation.
Project boundary
A query such as
john cenareturns ranked stored assets for the user to inspect and choose.Phase 1 builds a deterministic local SQLite/FTS corpus from a cleared fixture.
Phase 2 implements BM25, a measured LSA dense experiment, deterministic hybrid fusion, evaluation, and the worker. BM25 remains the default because fusion did not pass the confidence rule.
Phase 3 implements a Rust TUI connected to one long-lived Python retrieval worker through a versioned local protocol.
Phase 4 is paused before release. Its design is one finite, human-reviewed Wikimedia Commons page-ID plan through the same corpus contract, not a general crawler.
Selection feedback is optional offline evidence, never live self-training.
Context-aware suggestions reuse retrieval only after the prompt-search product works.
MMTS-Search-v1, component metrics, and contract tests justify each implemented stage.
Understand the system and corpus
Architecture
Components, Rust and Python ownership, process boundaries, data flow, contracts, and repository shape.
Data pipeline
Source policy, parsing, canonical meme records, enrichment, deduplication, storage, publication, and pipeline health.
Wikimedia Commons source
Reviewed Wikimedia Commons acquisition plan, network boundary, rights mapping, durable resume, deletion handling, and source metrics.
Retrieval
Query semantics, lexical and dense retrieval, rank fusion, filtering, result contracts, and selection feedback.
Interface
Rust terminal workflow, screen states, result previews, worker lifecycle, selection behavior, and accessibility boundary.
Validate and plan delivery
Testing
Contract-based unit, integration, end-to-end, security, TUI, evaluator, and performance test matrix.
Evaluation
Search benchmark, relevance and performance metrics, selection diagnostics, Technical Score, gates, and comparison protocol.
Development plan
Completed foundations, paused external-source work, dependency-ordered resume stages, exit gates, and future boundaries for MamboMeme.
Project status
MamboMeme is paused after the complete Phase 3 local source release. Phase 4's reviewed Commons source, deletion handling, stale-process protection, controlled network tests, and source report are designed but not released. MMTS-Search-v1 remains unscored until an independent human-labelled hidden benchmark with its safety subset exists; no context assistant, public API, packaged distribution, or deployment target is implemented.