Repository navigation
v0.2.3 - Persistent User Config, AI Mnemonic Wizard, Authoring Studio & Dynamic Target Resolution
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.yamlare 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:
- Workspace
.env:./.envin the current working directory. - User Global
.env:~/.mnemolink/.envin the user's home directory. - Process Environment: Existing environment variables (
os.environ). - 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/.envfor 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, printsollama pull <model>instructions, and allows the user to choose:use anyway,pick installed, orre-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:
- AI Elicitation Wizard: Guides users through conversational prompts to elicit authentic failure modes, operational scars, boundaries, and teleological drives, then synthesizes compliant assets.
- Guided Manual Authoring: Prompts for each schema field step-by-step with real-time field tooltips and Pydantic validation.
- Fast Template Scaffolder: Emits raw schema templates directly into target directories.
- Architectural Role Clarity:
author/wizardhandles asset manufacturing (writing.yamlandcard.jsonto disk), whereascomposehandles prompt assembly (compiling catalog assets into target-model prompts). - Strict 5-Kind Taxonomy: Supports
lore,work,incident,relational, andtelemetry. - 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]asauthor(authoring hub), eliminating naming conflicts between wizard and template scaffolding. - Added menu option
[8]asconfigfor direct interactive settings and API credential management. - Headless and non-TTY invocations cleanly fall back to standard
argparseusage 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, andconfig show/set.
- 100% offline isolation: Zero network requests or
.envleaks in test execution.
Installation
pip install -U mnemolinkContributors
- @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
- Documentation: docs/
- CLI Reference: docs/cli.md
- Usage Guide: docs/usage_guide.md
- Universal Adapters: docs/adapters.md
- Empirical Benchmark Suite: docs/bench/README.md
- Comparison Matrix: COMPARISON.md
- Zenodo Concept DOI: https://doi.org/10.5281/zenodo.22727029
- Full Changelog: CHANGELOG.md