# Medicine Wheel

> A comprehensive TypeScript framework for relational healing, ceremonial inquiry, and Indigenous-aligned software development — grounded in the Four Directions, Wilson's three R's, and OCAP® data sovereignty principles.

**Version:** 0.1.1
**Language:** TypeScript (ES2022, ESM)
**License:** MIT

## Packages

- [ontology-core](src/ontology-core): Foundational ontology layer for the Medicine Wheel Developer Suite — unified types, RDF vocabulary, Zod schemas, constants, semantic query helpers grounded in Indigenous relational ontology
- [ceremony-protocol](src/ceremony-protocol): Ceremony lifecycle protocol — manages ceremony state, phase transitions, governance enforcement, and ceremonial review workflows
- [narrative-engine](src/narrative-engine): Beat sequencing, arc validation, cadence patterns, and timeline building for the Medicine Wheel Developer Suite
- [graph-viz](src/graph-viz): Medicine Wheel graph visualization — circular layout with four-direction node positioning, ceremony-aware edges, and OCAP® indicators
- [relational-query](src/relational-query): Query builder, graph traversal, and accountability audit for the Medicine Wheel relational web. Protocol-aware: respects ceremony boundaries and OCAP® compliance during traversal.
- [prompt-decomposition](src/prompt-decomposition): Ontology-enriched prompt decomposition engine for the Medicine Wheel Developer Suite — intent extraction, relational dependency mapping, and ceremony-aware action stacking
- [ui-components](src/ui-components): React UI components for the Medicine Wheel Developer Suite — direction cards, beat timelines, node inspectors, OCAP® badges, and Wilson alignment gauges.
- [data-store](src/data-store): Shared Redis data-access layer for the Medicine Wheel Developer Suite — connection management, Node/Edge/Ceremony CRUD, session-ceremony linking, and discovery helpers
- [session-reader](src/session-reader): Session event reader for the Medicine Wheel Developer Suite — JSONL parsing, session summaries, analytics extraction, and search across agent session data

## Specifications (RISE Framework)

- [System Spec](rispecs/medicine-wheel.spec.md): Top-level overview linking all packages
- [ontology-core](rispecs/ontology-core.spec.md): Types, schemas, vocabulary, constants, queries
- [ceremony-protocol](rispecs/ceremony-protocol.spec.md): Ceremony state, phases, governance
- [narrative-engine](rispecs/narrative-engine.spec.md): Sequencing, cadence, arc, timeline, cycle
- [graph-viz](rispecs/graph-viz.spec.md): Layout engine, SVG paths, data converters
- [relational-query](rispecs/relational-query.spec.md): Query, traversal, audit, Cypher
- [prompt-decomposition](rispecs/prompt-decomposition.spec.md): Decomposer, enricher, storage
- [ui-components](rispecs/ui-components.spec.md): React components
- [data-store](rispecs/data-store.spec.md): Redis data access, Node/Edge/Ceremony CRUD, session linking
- [session-reader](rispecs/session-reader.spec.md): Session event parsing, summaries, analytics

## Documentation

- [llms-full.txt](llms-full.txt): Exhaustive reference with code samples and full API
- [rispecs/CLAUDE.md](rispecs/CLAUDE.md): Specification index
- [llms/llms-rise-framework.txt](https://llms.jgwill.com/llms-rise-framework.txt): RISE methodology guide
- [llms/llms-kinship-hub-system.md](https://llms.jgwill.com/llms-kinship-hub-system.md): Kinship hub protocol

## Key Concepts

- **Four Directions**: East (vision/Waabinong), South (growth/Zhaawanong), West (reflection/Epangishmok), North (wisdom/Kiiwedinong)
- **Wilson's Three R's**: Respect, Reciprocity, Responsibility — scored 0–1 per relation
- **OCAP®**: Ownership, Control, Access, Possession — Indigenous data sovereignty
- **Structural Tension**: Germination → Assimilation → Completion creative cycle
- **Ceremonial Inquiry**: opening → council → integration → closure phase progression