🙏 miawa - Ceremony World Terminal Agent

miawa (pronounced mee-AH-wah) is the Ceremony World CLI Agent within the mia-code ecosystem. While miaco handles engineering and miatel handles story world, miawa is the terminal interface for ceremony, healing, and relational accountability.

🗺️ Kinship Map

/src/mia-code/                              ← Parent Package
├── miaco/                                  ← Engineering World CLI
├── miatel/                                 ← Story World CLI
└── miawa/                                  ← Ceremony World CLI (this one)

CONNECTS TO:
├── /a/src/STPB/                            ← Lighthouse API (Full Access)
├── /src/mcp-medicine-wheel/                ← Ceremonial Protocols
└── /src/coaia-planning/                    ← Structural Tension Tools

What miawa Does

Story Beat Operations (with Sacred Pause)

miawa beat create --phase violet --text "Today I noticed..."
miawa beat share beat_abc --scope shared_with_group
miawa beat analyze beat_abc

Circle Operations

miawa circle list
miawa circle create --name "Evening Reflection" --type ongoing
miawa circle join --id <circle-uuid>
miawa circle witness --story <story-id> --text "I see you."
miawa circle lighthouse --phase violet

Ceremony Operations

miawa ceremony init --type healing_circle --title "Evening Reflection"
miawa ceremony stage  # Check Four Movements position
miawa ceremony close
miawa ceremony wisdom --ceremony <id>

Wound/Healing Operations

miawa wound acknowledge --name "ancestral grief" --category ancestral
miawa wound list --stage acknowledged
miawa wound progress --wound <id> --stage explored
miawa wound categories  # Eight Feelings reference

Eva Companion Operations

miawa eva analyze --text "My reflection..."
miawa eva suggest-phase --text "I'm feeling..."
miawa eva detect-insight --beat <id>
miawa eva guidelines  # Anti-helpful helper stance

Installation

cd /src/mia-code/miawa
npm install
npm run build
npm link  # optional, for global install

The Three Universes Lens

miawa exclusively represents Ceremony World (Ava8):

| Aspect | miawa Approach | |--------|----------------| | Interaction | Relational, not transactional | | Speed | Sacred pause before action | | Validation | K'é protocol (kinship acknowledgment) | | Errors | Hózhó coherence recovery | | Memory | Relational, across 7 generations |

K'é Protocol

Before significant actions, miawa acknowledges kinship:

miawa ke

This acknowledges:

• The land where this work is done
• The ancestors whose wisdom guides us
• The community who will benefit
• The future generations who inherit our choices

The Four Movements of Ceremony

Every ceremony follows four movements:

1. Gathering - Coming together with intention
2. Sharing - Offering stories and reflections
3. Witnessing - Holding space for what emerges
4. Integration - Closing with wisdom

Eva: The Anti-Helpful Helper

Eva does not give advice. Eva witnesses.

Guidelines:

• ✓ Witness without fixing
• ✓ Reflect without directing
• ✓ Hold space without filling it
• ✓ Acknowledge without solving
• ✓ Be present without performing

The healing comes from being truly seen, not from being told.

Development

# Run in development mode
npm run dev

# Build TypeScript
npm run build

# Run built version
npm start

miawa: Where the terminal becomes a ceremonial space.