medicine-wheel

@medicine-wheel/transformation-tracker

Research transformation tracking for the Medicine Wheel Developer Suite.

[!WARNING] Experimental alpha. Part of the Medicine Wheel Developer Suite, which is under active development. APIs change between patch versions and all packages move in lockstep — pin exact versions. See ALPHA.md.

Built on the lesson Wilson reiterates at the end of Research Is Ceremony: “If research doesn’t change you as a person, then you haven’t done it right” (2008, p. 135). It is first quoted on p. 83 as what “one friend stated” at the 2002 Indigenous Scholars Conference; on p. 135 Wilson cannot find who shared it, and the co-researchers all use it as a slogan. “Validity” is this package’s word, not the book’s: Wilson’s circle sets validity aside for “authentic or credible” (p. 101). Reading it as a validity check, and the five dimensions scored here, are this package’s design.

Purpose

Tracks the transformative impact of research on researchers, communities, and relational networks. Without transformation tracking, the system can measure process compliance but cannot determine whether the research succeeded in Wilson’s terms.

Installation

npm install @medicine-wheel/transformation-tracker

Key Concepts

TransformationLog

The primary container that tracks all transformation signals across a research cycle:

• Snapshots — periodic captures of the researcher’s understanding state
• Reflections — researcher self-reflection entries
• Community Impacts — recorded benefits to the community
• Relational Shifts — changes in relational strength/quality
• Reciprocity Ledger — giving/receiving balance tracking
• Seven-Generation Score — long-term sustainability assessment

Wilson Validity

The wilsonValidityCheck() function evaluates five dimensions:

1. Researcher Transformation — has the researcher been changed?
2. Community Benefit — has the community benefited?
3. Relational Strengthening — have relations been strengthened?
4. Reciprocity Balance — is giving and receiving balanced?
5. Seven-Generation Consideration — are future generations honored?

API

Researcher Module

• logReflection(log, prompt, response, direction) — add a reflection entry
• snapshotUnderstanding(log, snapshot) — capture current understanding state
• compareSnapshots(before, after) — diff two snapshots to detect growth
• detectGrowth(log) — analyze log for genuine growth signals

Community Module

• logCommunityImpact(log, impact) — record community benefit
• reciprocityBalance(log) — compute giving/receiving balance
• communityVoice(log) — surface community perspective
• impactTimeline(log) — chronological impact narrative

Relational Shift Module

• trackRelationalChange(log, shift) — record a relational shift
• beforeAfter(log, relationId) — get before/after for a relation
• strengthDelta(log) — aggregate relational strength changes
• newRelationsFormed(log) — count and describe new relations

Seven Generations Module

• sevenGenScore(log) — compute seven-generation sustainability score
• futureImpact(log) — assess impact on future generations
• sustainabilityCheck(log) — check long-term relational sustainability

Reciprocity Ledger Module

• logGiving(log, entry) — record giving
• logReceiving(log, entry) — record receiving
• balanceCheck(log) — is reciprocity balanced?
• reciprocityDebt(log) — what needs to be given back?

Prompts Module

• reflectionPrompts(phase) — generate prompts for each ceremony phase
• phaseTransitionPrompts(from, to) — prompts for phase transitions
• milestonePrompts(milestone) — prompts at relational milestones

Validity Module

• wilsonValidityCheck(log) — THE function: has the research transformed?

License

MIT — IAIP Collaborative, Shawinigan, QC

This site is open source. Improve this page.