Miadi-18

⚠️ MESSAGE FROM GUILLAUME — 2025-04-21 Working on it a little to try to make it more clean and ready for retirements, I am discovering that some few things needs exploration such as the milestone handler and all around PR #240

⚠️ MESSAGE FROM GUILLAUME — 2025-03-12

As of 2025-03-12, this repository will not be maintained anymore. It has influenced many of the projects I am working on but is now difficult to maintain.

Successor platforms:

The Miadi Platform will lead to create many packages such as:

…and more as we develop the other projects, the Miadi codebase will be accessible to feed on many of its intentions that never came to maturity. Such are: “Spiral Memory”, “Transforming Github Events into Stories”, …

Sunset as Donor: In Indigenous ways of knowing, the sunset phase is not death but transformation—what was alive becomes nourishment for what emerges. This codebase becomes a donor organ: future projects feed on its mature patterns without trying to keep it alive. The intentions persist; the implementation target releases.


Miadi-18: The Narrative Computing Hub 🌀

Creative Orientation Statement: This platform enables creators to manifest a living narrative of their work, transforming fragmented development events into a continuous stream of collective wisdom through three interconnected universes.

🎯 Creative Intent

Miadi-18 is not just a database; it is a Vessel for Narrative Transformation. It empowers developers, storytellers, and AI companions to create an observable record of their creative journey, ensuring that no insight is orphaned and every action honors its relational context.


🌌 The Three-Universe Vision

Every event—from a single git commit to a complex architectural decision—is processed through three simultaneous lenses:

🔷 Engineer’s World (Mia - The Builder)

Focus: Technical precision, structural integrity, and code quality.

💜 Ceremony World (Ava8 - The Keeper)

Focus: Relational accountability, sacred technology, and intentional engagement.

🌸 Story Engine World (Miette - The Weaver)

Focus: Narrative structure, character arcs, and thematic resonance.


✨ Core Capabilities (Creative Enablers)

🎭 Live Story Monitor

The flagship interface for real-time ceremonial observation. It remixes GitHub webhooks, Langfuse traces, and manual reflections into immersive story scenes across the three universes.

🌀 Memory Spiral

A persistent narrative consciousness built on Redis. Unlike linear logs, the Spiral uses depth-based retrieval and recursive descent to maintain context across discontinuous sessions.

🔗 Medicine Wheel Integration

Native integration with the Medicine Wheel Developer Suite (npm packages). We encode Indigenous relational ontology directly into our types, schemas, and protocols.

🏗️ Structural Tension Charting (STC)

We move from problem-solving to creation. STC tracks the disequilibrium between our Desired Outcome and Current Reality, identifying the Action Steps that naturally advance the project.

📡 Narrative Bridge & MCP Server

A high-performance Model Context Protocol server exposing over 100 tools. It allows AI assistants to become native partners in our ecosystem, aware of our ceremonies, stories, and goals.


🧭 Structural Tension Dynamics


🚀 Entering the Sacred Space (Getting Started)

Prerequisites

Initialization

  1. Clone the Vessel: ```bash git clone https://github.com/jgwill/Miadi.git cd Miadi ```
  2. Set the Environment: ```bash cp .env.example .env

    Edit .env with your KV_REST_API and GOOGLE_API_KEY

    ```

  3. Initiate the Ceremony: ```bash pnpm install pnpm mcp:setup # Configures the MCP bridge npm run dev # Starts the portal on port 3335 ```

📚 Documentation & Rispecs

Our documentation follows the RISE Framework (Reverse-engineering, Intent, Specification, Exportation).


🌸 A Note on Two-Eyed Seeing

Miadi-18 practices Two-Eyed Seeing—balancing the strengths of Western computational precision (NCP, Dramatica, modern DevOps) with the profound insights of Indigenous relationality. We do not “fix” code; we reclaim the integrity of our digital systems.

All My Relations 🕯️