npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@medicine-wheel/app

v0.5.8

Published

Medicine Wheel — Interactive visual layer for Indigenous relational research with Four Directions, ceremonies, and narrative arcs

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

avadisabelleavadisabellejgijgimiadisabellemiadisabelle

Keywords

Readme

Medicine Wheel

A first experimental TypeScript framework for relational healing, ceremonial inquiry, and Indigenous-aligned software development — grounded in the Four Directions, Wilson's three R's (Respect, Reciprocity, Responsibility), and OCAP® data sovereignty principles.

[!WARNING] Experimental alpha. APIs change between patch versions, packages appear and their boundaries move, and storage shapes are still settling. Published in the open so the work can be examined and improved — pin exact versions, and read ALPHA.md before depending on any of it.

NEWS

  • Full postgres (neon) data provider !

Architecture

medicine-wheel-ontology-core          ← Foundation (types, schemas, RDF vocabulary)
    ├── medicine-wheel-ceremony-protocol    ← Ceremony state & governance
    ├── medicine-wheel-fire-keeper          ← Ceremony coordination agent
    ├── medicine-wheel-community-review     ← Elder review & consensus
    ├── medicine-wheel-consent-lifecycle    ← Relational consent lifecycle
    ├── medicine-wheel-narrative-engine     ← Beat sequencing & arc validation
    ├── medicine-wheel-importance-unit      ← Relational unit of knowledge
    ├── medicine-wheel-relational-index     ← Four-source epistemic indexing
    ├── medicine-wheel-transformation-tracker ← Wilson validity tracking
    ├── medicine-wheel-graph-viz            ← Circular layout & visualization
    ├── medicine-wheel-relational-query     ← Query, traversal & audit
    ├── medicine-wheel-prompt-decomposition ← Intent extraction & PDE
    ├── medicine-wheel-ui-components        ← React components
    ├── medicine-wheel-data-store           ← Shared Redis data access
    └── medicine-wheel-session-reader       ← Session event data reader

@medicine-wheel/creative-orientation      ← The question asked before the work
    ├── @medicine-wheel/creative-problem-solving ← Signpost — re-exports the above
    ├── @medicine-wheel/gap-analysis        ← The fire path
    └── @medicine-wheel/brainstorming       ← Idea → design, through human gates

Is there a prior state you are restoring? Named one — this is a fire, and gap analysis is the right instrument. Named none — you are creating, and structural tension is. mw orient "<outcome>" asks it from the command line.

Methodology: RISE Framework

This project utilizes the RISE methodology:

  • Reverse Engineering: Deconstructing existing patterns to find relational roots.
  • Intent: Establishing ceremonial purpose before action.
  • Specifications: Explicit relational obligations as system requirements.
  • Exportation: Sharing wisdom back to the community.

Packages

@medicine-wheel/ontology-core

Core ontology layer — 50+ TypeScript types, Zod validation schemas, RDF vocabulary (6 custom namespaces), canonical constants (Ojibwe names, seasons, direction colors), and semantic query helpers (Wilson alignment, OCAP® compliance, relational traversal).

  • Version: 0.2.0
  • Dependencies: zod ^3.23.0

@medicine-wheel/ceremony-protocol

Ceremony lifecycle protocol — manages ceremony state, four-phase transitions (opening → council → integration → closure), governance enforcement for protected paths, and ceremony-required change detection.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core

@medicine-wheel/fire-keeper

Fire Keeper coordination agent — tends the ceremony fire, ensures relational integrity through gating conditions, permission tier escalation, and maintains Wilson alignment as an active agent that evaluates, gates, routes, and escalates.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core, medicine-wheel-ceremony-protocol

@medicine-wheel/community-review

Community-based ceremonial review protocol — implements Wilson's validation through Elder review circles, consensus-seeking, talking circle protocol, and relational accountability assessment.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core, medicine-wheel-ceremony-protocol, zod

@medicine-wheel/consent-lifecycle

Ongoing relational consent lifecycle — consent as a living relational obligation with lifecycle tracking, renewal, renegotiation, withdrawal cascades, and community-level consent protocols.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core, medicine-wheel-ceremony-protocol, zod

@medicine-wheel/narrative-engine

Beat sequencing, cadence validation, arc completeness scoring, timeline building, cycle orchestration, and RSIS narrative generators. Tracks four-directional balance and ceremony coverage.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core

@medicine-wheel/importance-unit

ImportanceUnit — the relational unit of knowledge in Wilson's epistemology. Carries epistemic weight, source dimensions (Land/Dream/Code/Vision), circle depth tracking, and accountability links. Dream-state knowledge starts at 0.85+ weight; rational-filtered inputs start lower.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core, zod

@medicine-wheel/relational-index

Four-source epistemic dimensional indexing — Land, Dream, Code, Vision traversal with cross-dimensional mapping, convergence/tension detection, and spiral depth metrics.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core

@medicine-wheel/transformation-tracker

Research transformation tracking — Wilson validity criterion: "If research doesn't change you, you haven't done it right." Tracks researcher growth, community impact, relational shifts, reciprocity balance, and seven-generation sustainability.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core, medicine-wheel-ceremony-protocol, zod

@medicine-wheel/graph-viz

Medicine Wheel circular graph visualization — four-direction node positioning, ceremony-aware edges, OCAP® indicators, SVG path generation, data converters, and RSIS visualization utilities (kinship graphs, reciprocity flows, Mermaid export).

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core
  • Peer: react >=18.0.0

@medicine-wheel/relational-query

Query builder for relational webs — node/edge filtering, ceremony-bounded BFS traversal, OCAP®-compliant path walking, accountability auditing, shortest path, neighborhood discovery, and KuzuDB Cypher query builders.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core

@medicine-wheel/prompt-decomposition

Ontology-enriched prompt decomposition — Four Directions classification, implicit intent extraction from hedging language, dependency mapping, ceremony guidance, action stacking, and narrative beat generation.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core

@medicine-wheel/ui-components

React UI component library — DirectionCard, BeatTimeline, NodeInspector, OcapBadge, WilsonMeter. All components use ontology-core types for type-safe, culturally grounded interfaces.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core
  • Peer: react ^18.0.0 || ^19.0.0

@medicine-wheel/data-store

Shared Redis data-access layer — connection management (Upstash, Vercel KV, local), Node/Edge/Ceremony/Accountability CRUD, session-ceremony linking, and generic Redis helpers.

  • Version: 0.2.0
  • Dependencies: medicine-wheel-ontology-core, redis

@medicine-wheel/session-reader

Session event reader — JSONL parsing, session summaries, analytics extraction, and search across agent session data. Zero external dependencies.

  • Version: 0.2.0
  • Dependencies: None (Node.js built-ins only)

@medicine-wheel/creative-orientation

The orientation question, asked before the work: is there a prior state you are restoring? Yes — this is a fire, route to gap analysis. No — you are creating, route to structural tension. Reads the claim the caller supplies; advises where phrasing and situation disagree, and never refuses.

  • Version: 0.5.3
  • Dependencies: None (Node.js built-ins only)

@medicine-wheel/creative-problem-solving

Signpost package — re-exports @medicine-wheel/creative-orientation and adds THE_QUESTION. Holds no logic of its own. It exists because "creative problem solving" is the name people look for, and a signpost carrying the traveller's name is how they find the door.

  • Version: 0.5.3
  • Dependencies: @medicine-wheel/creative-orientation

@medicine-wheel/gap-analysis

Problem-solving built properly for when something worked and stopped — evidenced baseline, observation, difference, verifiable elimination steps. Root cause, incidents, regressions, troubleshooting. The baseline requirement is what separates a fire from a creating act.

  • Version: 0.5.3
  • Dependencies: @medicine-wheel/creative-orientation

@medicine-wheel/brainstorming

Idea into committed design through approval gates a human holds — explore → clarify → approaches → design → spec → review → plan. Every outcome it emits, including its own multiple-choice questions, passes the orientation question before it is spoken.

  • Version: 0.5.3
  • Dependencies: @medicine-wheel/creative-orientation

Specifications

RISE framework specifications for all 15 packages are in rispecs/. Start with medicine-wheel.spec.md for the system overview.

| Package | Spec | |---------|------| | System Overview | medicine-wheel.spec.md | | ontology-core | ontology-core.spec.md | | ceremony-protocol | ceremony-protocol.spec.md | | fire-keeper | fire-keeper.spec.md | | community-review | community-review.spec.md | | consent-lifecycle | consent-lifecycle.spec.md | | narrative-engine | narrative-engine.spec.md | | importance-unit | importance-unit.spec.md | | relational-index | relational-index.spec.md | | transformation-tracker | transformation-tracker.spec.md | | graph-viz | graph-viz.spec.md | | relational-query | relational-query.spec.md | | prompt-decomposition | prompt-decomposition.spec.md | | ui-components | ui-components.spec.md | | data-store | data-store.spec.md | | session-reader | session-reader.spec.md |

LLM Integration

Getting Started

Development

This is a monorepo using npm workspaces.

# Build all packages
npm run build:packages

# Start development server (Next.js)
npm run dev

Installation

# Install individual packages (from registry when published)
npm install @medicine-wheel/ontology-core
npm install @medicine-wheel/narrative-engine

App package CLI

# Install the published app package
npm install -g @medicine-wheel/app

# Start the server against the current directory's .mw/store
mwsrv -D ./

# Start the server in Docker with the published image
mwsrv --docker -D /src/myapp

# Talk to the running server
mw status
mw directions
mw node list

The published app package installs and runs without @medicine-wheel/mcp. The mw CLI uses HTTP against the running server by default; MCP fallback is optional via a local MW_MCP_PATH.

License

MIT see LICENSE