medicine-wheel

medicine-wheel-fire-keeper

The Fire Keeper — ceremony coordination agent for Medicine Wheel

The Fire Keeper tends the ceremony fire, ensures relational integrity through gating conditions, and maintains Wilson alignment as an active agent — not a passive metric.

Purpose

Wilson’s ceremony requires a keeper. Without one, ceremony degrades into process. The Fire Keeper embodies relational accountability as an active agent that:

• Evaluates incoming ImportanceUnits against gating conditions
• Gates work through relational check-back protocol
• Tracks extended ceremony phases (gathering → kindling → tending → harvesting → resting)
• Escalates to human decision-makers at defined decision points
• Issues stop-work orders when relational accountability is violated

Key Modules

Module	Purpose
keeper.ts	FireKeeper class — core coordination engine
gating.ts	Gate evaluation and default gates (Wilson, OCAP, ceremony phase)
decisions.ts	Human-in-the-loop decision detection and permission escalation
check-back.ts	Four-step relational check-back protocol
ceremony-state.ts	Extended ceremony state management
trajectory.ts	Trajectory confidence and value divergence detection
messages.ts	A2A message type definitions

Usage

import {
  FireKeeper,
  DEFAULT_GATES,
  type FireKeeperConfig,
} from 'medicine-wheel-fire-keeper';

const config: FireKeeperConfig = {
  trajectoryThreshold: 0.65,
  permissionTiers: ['observe', 'analyze', 'propose', 'act'],
  gatingConditions: DEFAULT_GATES,
  humanDecisionPoints: [],
};

const keeper = new FireKeeper(config);
const ceremony = keeper.beginCeremony('inquiry::my-research');
const result = keeper.evaluateImportance({ id: 'unit-1', title: 'Vision' }, 'inquiry::my-research');

Permission Tiers

Tier	Scope	Human Required
🟢 observe	Read files, gather context	No
🟡 analyze	Produce analysis, create ImportanceUnits	No
🟠 propose	Draft artifacts, suggest schemas	No (Fire Keeper reviews)
🔴 act	Generate code, create commits	Yes

Relational Check-Back Protocol

Before any autonomous action, the Fire Keeper verifies:

1. Does this action honor existing relations?
2. Does it strengthen the Spirit-Body relationship?
3. Is it accountable to all four directions?
4. Would an Elder approve?

License

MIT

This site is open source. Improve this page.