Skip to content

v0.2.3 - Persistent User Config, AI Mnemonic Wizard, Authoring Studio & Dynamic Target Resolution

Choose a tag to compare

@rosspeili rosspeili released this 13 Sep 14:18
· 7 commits to main since this release

MnemoLink v0.2.3 establishes the creation and persistence tier for the mnemonic ecosystem: global user configuration (~/.mnemolink/config.yaml), a secure 3-tier credential precedence hierarchy with auto-persistence, dynamic execution target selection (Cloud APIs vs. Local Ollama) with real-time daemon verification, an interactive AI Mnemonic Wizard & Authoring Studio (mnemolink author / mnemolink wizard), and menu option consolidation.


Key Highlights in v0.2.3

1. Persistent User Configuration Architecture (~/.mnemolink/config.yaml)

MnemoLink now persists user preferences, terminal themes, target endpoints, and custom catalog directories across CLI sessions, mirroring the ARPA Skillware and AURA configuration pattern:

  • Global User Settings: Stores active theme (pastel, ocean, mono), preferred provider, active model, custom Ollama host, author name, and private catalog directory paths.
  • Dynamic Catalog Discovery: Any custom catalog roots declared in config.yaml are discovered seamlessly across all search hierarchies (Project Local -> User Global -> Bundled Package).
  • CLI Commands:
    • mnemolink config / mnemolink config show: Displays formatted tables of all active settings, config file paths, and API credential statuses.
    • mnemolink config set <key> <value>: Programmatically updates settings from the terminal (theme, model, provider, ollama_host, catalog_root).

2. 3-Tier Credential Precedence & Auto-Persistence (~/.mnemolink/.env)

API credentials are automatically resolved across a strict 3-tier precedence:

  1. Workspace .env: ./.env in the current working directory.
  2. User Global .env: ~/.mnemolink/.env in the user's home directory.
  3. Process Environment: Existing environment variables (os.environ).
  4. Interactive Secure Prompt: If no key is found, the CLI displays a rich tooltip with the direct console link for the provider (Google AI Studio, Anthropic Console, Mistral Console, OpenAI Platform) and prompts for the key, saving it to ~/.mnemolink/.env for all subsequent runs.

3. Dynamic Model Selection & Local Ollama Daemon Verification

Models are never hardcoded. Whenever a model is selected (for authoring or live benchmarks), users explicitly choose:

  • Cloud Provider APIs: Select Google Gemini, Anthropic Claude, Mistral AI, or OpenAI. The CLI prints official documentation URLs and active 2026 models (claude-sonnet-5, gemini-3.5-flash, gpt-5.6-luna, ministral-8b-latest), prompting the user to type or paste the exact model identifier.
  • Local Ollama Verification: Queries the local daemon via list_ollama_local_models(cfg.ollama_host). If missing, it provides a warning, lists installed models, prints ollama pull <model> instructions, and allows the user to choose: use anyway, pick installed, or re-enter.

4. Interactive AI Mnemonic Wizard & Authoring Studio (mnemolink author / mnemolink wizard)

Delivers a multi-track authoring suite for creating verified personas, episodic memories, and causal lineages:

  • Three Creation Paths:
    1. AI Elicitation Wizard: Guides users through conversational prompts to elicit authentic failure modes, operational scars, boundaries, and teleological drives, then synthesizes compliant assets.
    2. Guided Manual Authoring: Prompts for each schema field step-by-step with real-time field tooltips and Pydantic validation.
    3. Fast Template Scaffolder: Emits raw schema templates directly into target directories.
  • Architectural Role Clarity: author / wizard handles asset manufacturing (writing .yaml and card.json to disk), whereas compose handles prompt assembly (compiling catalog assets into target-model prompts).
  • Strict 5-Kind Taxonomy: Supports lore, work, incident, relational, and telemetry.
  • Dual Manifest Emission: Emits both schema manifest (*.yaml) and companion discovery card (card.json).
  • Resilience Engine: Features 8,192 token output ceilings, self-healing JSON retry loops, and exponential backoff on HTTP 429/503 rate limits.

5. Interactive Menu Consolidation (mnemolink)

  • Unified menu option [5] as author (authoring hub), eliminating naming conflicts between wizard and template scaffolding.
  • Added menu option [8] as config for direct interactive settings and API credential management.
  • Headless and non-TTY invocations cleanly fall back to standard argparse usage and exit 0 without hanging.

6. Expanded Unit & Integration Test Suite (93 Passing Tests)

  • Expanded test coverage from 50 to 93 passing tests in < 3.0s:
    • tests/test_config.py (12 tests): YAML serialization, 3-tier precedence, credential status, and Ollama tags.
    • tests/test_wizard.py (27 tests): JSON cleanup, self-healing retries, 429 backoff, manual & AI authoring across all 5 memory kinds, and Ollama verification.
    • tests/test_cli.py (20 tests): Splash logo, theme persistence, interactive dispatch, and config show/set.
  • 100% offline isolation: Zero network requests or .env leaks in test execution.

Installation

pip install -U mnemolink

Contributors

  • @rosspeili for the persistent configuration architecture, 3-tier credential precedence, dynamic target resolution, AI Mnemonic Wizard, and Authoring Studio (#4).
  • @bd-c3 for the interactive terminal splash menu, gradient rendering engine, and core CLI dispatch foundations (#1, #2).

Reference Links