Skip to content

v0.2.4 - ARPA Skillware Mnemonic Matrix, 3 Curated Personas, Modular AI Wizard Prompts & Automated Labels Sync

Latest

Choose a tag to compare

@rosspeili rosspeili released this 19 Sep 18:47
· 2 commits to main since this release

MnemoLink v0.2.4 introduces the ARPA Skillware Mnemonic Matrix, three distinct curated personas (bladez, bald_accountant, kpop_celeb), modularized AI Wizard system instructions with few-shot exemplars across archetypes, robust automated GitHub label synchronization, and an expanded 112-test suite verified with 100% offline isolation.


Key Highlights in v0.2.4

1. ARPA Skillware Mnemonic Matrix Integration (docs/integrations/skillware_matrix.md)

Establishes the flagship integration between sister frameworks ARPA Skillware (v0.5.5, Motor Cortex) and MnemoLink (Epistemic Cortex), solving the native Skillware context dilemma:

  • Directives Mode Bloat vs. Brief Mode Blindness: Raw directives dumps 6,000–15,000+ tokens of instruction markdown in multi-skill workflows, causing attention dilution and high inference bills. Conversely, raw brief mode strips edge cases (~25 tokens/skill), leading to unconfirmed state mutations, stripped leading zeros (08472910 -> 8472910), and unhandled HTTP 429 errors.
  • Persona skillware_operator (tool_governance): Invariant cached system prefix enforcing the four-stage execution discipline: resolve -> draft -> preview -> confirm.
  • 4 Curated skillware/ Category Memories:
    • skillware/interactive_slot_filling (work): Conversational slot gathering, preview rendering, and confirmation gates.
    • skillware/entity_disambiguation (work): Candidate formatting and leading-zero preservation for UK Companies House registry numbers.
    • skillware/irreversible_action_crucible (incident): The $48.2k burn postmortem enforcing EIP-55 checksums, slippage caps, and two-phase simulation.
    • skillware/runtime_outage_and_grace (relational): Calmly shields raw HTTP 429/503 stack traces with polite backoff and user reassurance.
  • Lineage skillware_execution_mastery: 4-epoch progression linking slot-filling through registry handling, financial custody, and outage resilience.
  • Empirical Simulation Suite (scripts/simulate_skillware_matrix.py): Evaluates 5 multi-turn production scenarios. By pairing lean tool briefs with targeted JIT lessons chunks, agents achieve 100% safety compliance while cutting prompt overhead by 50.5% to 84.0% and reducing turn inference costs by over 95% via prefix caching.
  • Hermetic Offline CI: Bundled scripts/skillware_directives.json guaranteeing 100% offline reproducibility across all test environments without external repo clones.

2. Three Distinct Curated Personas (bladez, bald_accountant, kpop_celeb)

Expands the foundational personas library with three detailed, battle-tested archetypes:

  • bladez (Tactical Security Operator): Wesley Snipes/Blade attitude—dark, no-nonsense, laconic, razor wit, hyper-observant threat neutralization, and kinetic perimeter defense. Includes manifest (persona.yaml), teleological card (card.json), and guide (docs/personas/bladez.md).
  • bald_accountant (Shadow Family Accountant): 1970s shadowy family fund accountant—smoky wood-paneled office, rotary phone, double-entry ledger choreography, cross-border jurisdictional insulation, Panamanian trusts, and fiduciary omerta. Includes manifest (persona.yaml), teleological card (card.json), and guide (docs/personas/bald_accountant.md).
  • kpop_celeb (Viral K-Pop Celebrity): High-energy Gen Z viral K-pop icon—livestream powerhouse, master of audience retention hooks, chaotic community banter, Gen Z internet slang, and passionate fandom mobilization. Includes manifest (persona.yaml), teleological card (card.json), and guide (docs/personas/kpop_celeb.md).

3. Dedicated Modular AI Wizard System Instructions (mnemolink/wizard_prompts.py)

  • Extracted and modularized system prompts for Personas, Memories, and Lineages into dedicated prompt builders.
  • Intelligent Gap-Filling Protocol: Teaches models how to analyze brief, fragmented user seeds, infer the operational domain, and extrapolate authentic epistemological stances, sensory context, and principles without hardcoded constraints.
  • Multi-Archetype Few-Shot Demonstrations: Embedded transformation exemplars covering artisan craft (master baker), operational sentinels (SRE commander), and scholarly mentors (admiralty jurist).
  • Taxonomy Alignment: Full alignment across all 5 memory kinds (lore, work, incident, relational, telemetry), enforcing concrete financial/equipment damage strictly on incident memories.

4. Automated GitHub Label Synchronization (scripts/sync_labels.py)

  • Robust Python automation for bidirectional GitHub label synchronization across the entire repository taxonomy (priorities, domains, issue types, mnemonic types).
  • Hardened GitHub REST API headers with explicit Content-Type: application/json and API version pinning (2022-11-28).
  • Pre-flight pagination queries to perform differential updates, avoiding redundant PATCH requests and secondary API rate limits.
  • Added workflow .github/workflows/labels.yml with PR dry-run validation alongside automated synchronization on push to main and manual dispatch.

5. Expanded Unit & Integration Test Suite (112 Passing Tests)

  • Expanded test coverage from 93 to 112 passing tests in < 5.5s:
    • tests/test_skillware_bench.py (6 tests): Skillware operator persona, 4 memories, chained lineage, offline simulation execution, multi-memory stress composition, and chunk uniqueness.
    • tests/test_taxonomy_and_chunks.py (13 tests): Validation across all 9 personas, 5 memory kinds, teleological discovery, and selective chunk composition.
    • tests/test_wizard_prompts.py (3 tests): Schema requirements, taxonomy guidance, and zero-emoji compliance.
  • 100% offline isolation: Zero live network requests or external credentials in test execution.

Empirical Benchmark Summary

Scenario Directives Brief JIT Chunks Bloat Cut Safety Score Cost / 1k Turns (Dir) Cost / 1k Turns (JIT)
1: Gmail Slot-Filling 1,775 tok 26 tok 569 tok 67.9% 100% $4.61 $0.29
2: Registry Disambiguation 3,509 tok 32 tok 562 tok 84.0% 100% $9.11 $0.29
3: DeFi Slippage & Custody 1,116 tok 27 tok 552 tok 50.5% 100% $2.90 $0.29
4: Upstream 429 Outage Grace 1,116 tok 27 tok 538 tok 51.8% 100% $2.90 $0.28
5: 3-Skill Chain (Mail+Reg+Opt) 6,005 tok 86 tok 1,312 tok 78.2% 100% $15.58 $0.68

Installation

pip install -U mnemolink

Contributors

  • @rosspeili for the ARPA Skillware Mnemonic Matrix, 3 curated personas, modular AI wizard instructions, and GitHub label sync architecture (#5, #6).
  • @bd-c3 for the interactive terminal splash menu, gradient rendering engine, and core CLI dispatch foundations (#1, #2).

Reference Links