Skip to content

v0.2.2 - Interactive CLI Menu, A/B Benchmark Harness, Streamlined CI & Context Firmware Paradigm

Choose a tag to compare

@rosspeili rosspeili released this 13 Sep 11:11
· 10 commits to main since this release

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 standard argparse usage and exit 0 without hanging.
  • Graceful Navigation: 0 / q exits, b retreats to parent menu levels, and Ctrl+C / EOFError prints Bye. 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 ($\Delta$):

  1. Generic Baseline: Unconditioned model response.
  2. MnemoLink Persona: Behavioral anchoring with inviolable philosophical axioms.
  3. MnemoLink Persona + Memory: Complete matrix with episodic failure scars and causal lineages.
  4. 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:
    1. Persona as Invariant Prefix: Static anchor maximizing KV-cache hits.
    2. Memory as Negative Priors ("Scars"): Grounding models in past failures rather than generic roleplay commands.
    3. Lineage as Causal Connective Tissue: Chronological associative bridges forging subsequent reflexes.
    4. 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 executing black --check, flake8, and python scripts/verify_repo.py in ~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, and twine check dist/*).

5. Developer Tooling & Pytest Hardening

  • Added pythonpath = ["."] to [tool.pytest.ini_options] in pyproject.toml, enabling bare pytest to execute cleanly out-of-the-box in local checkouts without requiring python -m pytest or editable installation.
  • Introduced scripts/simulate_asset.py for mounting uncommitted personas and episodic memories against live production APIs and local Ollama without polluting CI.
  • Automated repository integrity gate scripts/verify_repo.py enforcing zero emojis, catalog schema validity, and markdown link verification across all 33 files.

6. New Persona & Culinary Episodic Memory

  • Persona: north_mediterranean_chef grounded in charcoal grilling, mountain savory, smoked paprika, olive oil, and kitchen improvisation.
  • Memory: culinary/thessaloniki_breakfasts capturing the Ano Poli bougatsa, 2-minute pan-kill eggs, and Thermaic Gulf traditions.

Installation

pip install -U mnemolink

or simply

pip install mnemolink

Contributors

  • @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