memory-share-kit 1.2.4.post2

Deterministic memory and governance for developers and AI agents.

📦 memory-share-kit

A lightweight cognitive runtime CLI for persistent memory + tool-driven reasoning.

---

🐍 Requirements

• Python 3.14.x Required
• This runtime is tested and supported strictly on Python 3.14.4+.

🖥 Supported Environment

• OS: Windows 10/11 (fully tested)
• Runtime: Python 3.14.4+
• Database: SQLite (bundled with Python 3.14, WAL + STRICT mode)

---

⚡ Install

pip install memory-share-kit

---

🚀 Quick Start

kit init

Initializes the local cognitive environment and seals the kernel.

---

🏗 Architecture Overview

The system operates as a deterministic cognitive substrate:

Agent / IDE
  ↓
Kit CLI (The Brain)
  ↓
Memory Router (Routing & Governance)
  ↓
SQLite Storage (JSONB + WAL + STRICT)

Verification Path (Forensic):
Kit CLI
  ↓
Vantage (The Sensor - Rust Core)
  ↓
Integrity Verification (Drift Detection)

---

🧠 Memory Topology

Kit enforces a 4-tier deterministic memory model:

• L1 — Local Brain: Repository-specific reasoning and context.
• L2 — Global Brain: Shared user-level knowledge across projects.
• L3 — Frozen Law: Immutable architectural invariants (Read-Only).
• L4 — Audit Trace: Forensic log of all cognitive routing decisions.

---

🧪 Minimal Workflow Example

The following sequence represents a standard deterministic session:

# 1. Initialize
kit init

# 2. Record a decision or invariant
kit learn --tag decision "Always use WAL mode for high concurrency"

# 3. Recall the context
kit recall

# 4. Verify structural integrity
kit-vantage verify-memory

---

🧠 Usage Summary

Store knowledge

kit learn --tag decision "Use WAL mode for deterministic writes"

Recall context

kit recall

Search memory

kit search "router failure"

Verify integrity

kit-vantage verify-memory

---

🔍 Verification Layer (Optional)

Kit supports external structural verification using Vantage. While optional, it is highly recommended for production-grade cognitive kernels to prevent drift and ensure topological integrity.

Install Vantage: https://github.com/so-sai/Vantage

After installation, you can run forensic verification:

kit-vantage verify-memory

---

🛡️ Core Principles

• Runtime is Truth: The executing environment is the only valid state.
• CLI is Interface: Clean, tool-first access to the cognitive kernel.
• Memory is Persistent: Deterministic storage with SQLite WAL + JSONB.
• Verification is External: Integrity is enforced by the Vantage sensor layer.

---

🛠️ Failure Recovery

If the system enters a friction state or memory drift is detected:

kit doctor          # Diagnose health
kit doctor --heal   # Automatically repair common artifacts

---

📌 Version

v1.2.4.post2