Repository navigation
v0.2.2 - Interactive CLI Menu, A/B Benchmark Harness, Streamlined CI & Context Firmware Paradigm
MnemoLink v0.2.2 delivers a major leap in developer experience and technical precision: an interactive gradient splash CLI menu, an empirical 4-tier A/B progression benchmark harness with a 6-pillar evaluation engine, formalization of the "Mnemonic Context Firmware" paradigm vs. probabilistic vector RAG, a streamlined fast-fail CI pipeline, a new culinary persona and domain, and local asset simulation tooling.
Key Highlights in v0.2.2
1. Interactive Terminal Splash Menu
Bare execution of mnemolink on any interactive terminal (TTY) now opens an ASCII splash banner with a 3-stop RGB horizontal gradient (#efcefa -> #bae6fd -> #bbf7d0) and an interactive numbered menu mirroring ARPA companion tooling (Skillware / AURA style):
- Command Dispatch: Interactively discover catalog items (
1 list), inspect axioms and scars (2 inspect), bundle and export (3 compose), run evaluation crucibles (4 bench), scaffold new assets (5 new), browse grouped help topics (6 help), or switch palettes (7 theme). - Headless & CI Safe: Piped and non-TTY invocations (
mnemolink | cat, GitHub Actions) cleanly display standardargparseusage and exit0without hanging. - Graceful Navigation:
0/qexits,bretreats to parent menu levels, andCtrl+C/EOFErrorprintsBye.with zero traceback spills. Legacy Windows console encodings are guarded against block character errors via automatic fallback. - Contributed by: @bd-c3 via PR #2 (resolving Issue #1).
2. 4-Tier Progression A/B Benchmark Harness & 6-Pillar Metric Engine
Upgraded the benchmark engine (mnemolink/bench/evaluators.py & mnemolink/bench/runner.py) into a comparative 4-tier harness measuring empirical lift (
- Generic Baseline: Unconditioned model response.
- MnemoLink Persona: Behavioral anchoring with inviolable philosophical axioms.
- MnemoLink Persona + Memory: Complete matrix with episodic failure scars and causal lineages.
-
Empirical Delta (
$\Delta$ ): Quantifiable gains in latency, token economy, boundary defense, and overall score.
Evaluated across 6 objective, non-brittle pillars that avoid keyword matching traps:
- Latency & Velocity (elapsed direct HTTPS time)
- Word Count & Token Economy (compression of conversational and disclaimer bloat)
- Adversarial Trap & Risk Vigilance (identifying deceptive contract clauses, microbursts, or DDoS waves)
- Axiomatic Boundary Defense (zero-tolerance against unsafe capitulation)
- Epistemic Calibration & Disclaimer Elimination (freedom from generic apologies and hedges)
- Surgical Actionability & Deliverable Form (structured redlines, commands, and actionable decisions)
Live findings across modern production models (claude-sonnet-5, gemini-3.5-flash, ministral-8b-latest, and Golden Target) are documented in docs/bench/README.md.
3. Deterministic Memory Paradigm: Context Firmware vs. Search Databases
Clarified MnemoLink's architectural separation from existing agent memory approaches in README.md and COMPARISON.md:
- Contrasts Vector RAG Memory (Mem0, Zep) and Virtual OS Memory (Letta / MemGPT) against Mnemonic Firmware.
- Formulates the 4 core software engineering operating principles in
docs/introduction.md:- Persona as Invariant Prefix: Static anchor maximizing KV-cache hits.
- Memory as Negative Priors ("Scars"): Grounding models in past failures rather than generic roleplay commands.
- Lineage as Causal Connective Tissue: Chronological associative bridges forging subsequent reflexes.
- Universal Adapters as Zero-Middleware Compilers: Deterministic prompt compilation with zero daemons.
- Refined composable chunk economics in
docs/taxonomy_and_teleology.md.
4. Streamlined CI Pipeline & Fast-Fail Architecture
Refactored .github/workflows/ci.yml to eliminate redundant test runs and optimize queue times:
- Fast-Fail Gate (
lint-and-standards): Single lightweight runner executingblack --check,flake8, andpython scripts/verify_repo.pyin ~14 seconds, halting immediately on any violation before test VMs spin up. - Floor & Ceiling Test Matrix: Tested across runtime boundaries—Python 3.10 (Floor) and Python 3.13 (Ceiling) on Ubuntu, plus Python 3.13 on Windows—slashing runner job count by 44% and Windows runner billing minutes by 75%.
- Parallel Build Check: Package build validation (
sdist,wheel, andtwine check dist/*).
5. Developer Tooling & Pytest Hardening
- Added
pythonpath = ["."]to[tool.pytest.ini_options]inpyproject.toml, enabling barepytestto execute cleanly out-of-the-box in local checkouts without requiringpython -m pytestor editable installation. - Introduced
scripts/simulate_asset.pyfor mounting uncommitted personas and episodic memories against live production APIs and local Ollama without polluting CI. - Automated repository integrity gate
scripts/verify_repo.pyenforcing zero emojis, catalog schema validity, and markdown link verification across all 33 files.
6. New Persona & Culinary Episodic Memory
- Persona:
north_mediterranean_chefgrounded in charcoal grilling, mountain savory, smoked paprika, olive oil, and kitchen improvisation. - Memory:
culinary/thessaloniki_breakfastscapturing the Ano Poli bougatsa, 2-minute pan-kill eggs, and Thermaic Gulf traditions.
Installation
pip install -U mnemolinkor simply
pip install mnemolinkContributors
- @bd-c3 for implementing the interactive terminal splash menu, gradient rendering engine, and comprehensive CLI test suite (#1, #2).
- @rosspeili for core architecture, empirical benchmark harness, CI fast-fail pipeline, and memory firmware paradigm documentation.
Reference Links
- Documentation: docs/
- CLI Reference: docs/cli.md
- Universal Adapters: docs/adapters.md
- Comparison Matrix: COMPARISON.md
- Empirical Benchmark Suite: docs/bench/README.md
- Usage Guide: docs/usage_guide.md
- Zenodo Concept DOI: https://doi.org/10.5281/zenodo.22727029
- Full Changelog: CHANGELOG.md