@medicine-wheel/fire-keeper 0.2.2

package/dist/types.d.ts

@@ -0,0 +1,161 @@
+/**
+ * @medicine-wheel/fire-keeper — Type Definitions
+ *
+ * Types for the Fire Keeper coordination agent.
+ * The Fire Keeper tends the ceremony fire, ensures relational integrity,
+ * and maintains Wilson alignment as an active agent — not a passive metric.
+ */
+import type { DirectionName } from '@medicine-wheel/ontology-core';
+/**
+ * Extended ceremony phases reflecting the full lifecycle of a ceremony.
+ * - gathering: Reading context, collecting materials, honoring what exists
+ * - kindling: East work — establishing vision and intent
+ * - tending: South/West work — analysis, validation, deepening
+ * - harvesting: North work — producing grounded artifacts
+ * - resting: Ceremony pause — integration period
+ */
+export type CeremonyPhaseExtended = 'gathering' | 'kindling' | 'tending' | 'harvesting' | 'resting';
+/** Status of a single quadrant (direction) within the ceremony */
+export interface QuadrantStatus {
+    /** Whether this quadrant has been visited, is active, or is pending */
+    status: 'pending' | 'active' | 'visited' | 'complete';
+    /** Number of ImportanceUnits associated with this quadrant */
+    unitCount: number;
+    /** Deepest circle depth reached in this quadrant */
+    deepestCircle: number;
+    /** ISO timestamp of last visit, or null if never visited */
+    lastVisited: string | null;
+}
+/** Context passed to gating condition evaluators */
+export interface FireKeeperContext {
+    /** Current ceremony state */
+    ceremonyState: CeremonyStateExtended;
+    /** The unit or action being evaluated */
+    unitId?: string;
+    /** Current Wilson alignment score (0–1) */
+    wilsonAlignment?: number;
+    /** OCAP compliance status */
+    ocapCompliant?: boolean;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/** A condition that must be satisfied before ceremony work can proceed */
+export interface GatingCondition {
+    /** Human-readable description of the condition */
+    condition: string;
+    /** Whether this condition must be satisfied (vs. advisory) */
+    required: boolean;
+    /** Function that evaluates whether the condition is met */
+    evaluator: (context: FireKeeperContext) => boolean;
+}
+/** Tracked status of a gating condition within ceremony state */
+export interface GatingConditionStatus {
+    /** Human-readable description of the condition */
+    condition: string;
+    /** Whether the condition has been satisfied */
+    satisfied: boolean;
+    /** ISO timestamp when satisfied, or null */
+    satisfiedAt: string | null;
+    /** Who/what satisfied the condition, or null */
+    satisfiedBy: string | null;
+}
+/**
+ * Permission tiers for agent escalation decisions.
+ * - observe: Read files, gather context (no human required)
+ * - analyze: Produce analysis, create ImportanceUnits (no human required)
+ * - propose: Draft artifacts, suggest schemas (Fire Keeper reviews)
+ * - act: Generate code, create commits, modify infrastructure (human required)
+ */
+export type PermissionTier = 'observe' | 'analyze' | 'propose' | 'act';
+/**
+ * Types of decision points where human-in-the-loop is triggered.
+ * - value-conflict: Trajectory diverges from values or gating override requested
+ * - permission-escalation: Agent requests action beyond current tier
+ * - circle-completion-review: All four quadrants visited — human confirms
+ * - modality-choice: Work requires specific skills/modality selection
+ */
+export type DecisionPointType = 'value-conflict' | 'permission-escalation' | 'circle-completion-review' | 'modality-choice';
+/** A decision point that may require human involvement */
+export interface DecisionPoint {
+    /** Category of decision */
+    type: DecisionPointType;
+    /** Function that determines whether this decision point is triggered */
+    trigger: (context: FireKeeperContext) => boolean;
+    /** Whether human involvement is mandatory at this point */
+    requiresHuman: boolean;
+}
+/** A checkpoint in the ceremony's trajectory history */
+export interface TrajectoryCheckpoint {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Confidence score (0–1) that the ceremony is on track */
+    confidence: number;
+    /** Direction active at this checkpoint */
+    direction: DirectionName;
+    /** Human-readable note about what occurred */
+    note: string;
+}
+/** A milestone in the relational journey of the ceremony */
+export interface RelationalMilestone {
+    /** Human-readable description of the milestone */
+    milestone: string;
+    /** Whether the milestone has been achieved */
+    complete: boolean;
+    /** Which quadrants are required for this milestone */
+    quadrantsRequired: DirectionName[];
+    /** Which quadrants have been touched so far */
+    quadrantsTouched: DirectionName[];
+}
+/** Emergency halt order when relational accountability is violated */
+export interface StopWorkOrder {
+    /** Agent targeted by the stop work order */
+    targetAgentId: string;
+    /** Reason for the halt */
+    reason: string;
+    /** ImportanceUnit ID involved, if any */
+    unitId: string | null;
+    /** Condition that must be met before work can resume */
+    resumeCondition: string;
+}
+/** Full ceremony state tracked by the Fire Keeper per active inquiry */
+export interface CeremonyStateExtended {
+    /** Reference to the active inquiry */
+    inquiryRef: string;
+    /** Current ceremony phase */
+    ceremonyPhase: CeremonyPhaseExtended;
+    /** Currently active direction */
+    activeDirection: DirectionName;
+    /** State of each quadrant */
+    quadrantState: Record<DirectionName, QuadrantStatus>;
+    /** Status of all gating conditions */
+    gatingConditions: GatingConditionStatus[];
+    /** Relational milestones for the ceremony */
+    relationalMilestones: RelationalMilestone[];
+    /** History of trajectory checkpoints */
+    trajectoryHistory: TrajectoryCheckpoint[];
+}
+/** Configuration for the Fire Keeper agent */
+export interface FireKeeperConfig {
+    /** Minimum trajectory confidence before human intervention (default: 0.65) */
+    trajectoryThreshold: number;
+    /** Ordered permission tiers */
+    permissionTiers: PermissionTier[];
+    /** Gating conditions to enforce */
+    gatingConditions: GatingCondition[];
+    /** Decision points that trigger human-in-the-loop */
+    humanDecisionPoints: DecisionPoint[];
+}
+/** Runtime state of the Fire Keeper agent */
+export interface FireKeeperState {
+    /** Whether the Fire Keeper is actively tending a ceremony */
+    active: boolean;
+    /** Active ceremony states, keyed by inquiry reference */
+    ceremonies: Record<string, CeremonyStateExtended>;
+    /** Current permission tier of the Fire Keeper itself */
+    currentTier: PermissionTier;
+    /** Active stop work orders */
+    activeStopWorkOrders: StopWorkOrder[];
+    /** Timestamp of last state update */
+    lastUpdated: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @medicine-wheel/fire-keeper — Type Definitions
+ *
+ * Types for the Fire Keeper coordination agent.
+ * The Fire Keeper tends the ceremony fire, ensures relational integrity,
+ * and maintains Wilson alignment as an active agent — not a passive metric.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@medicine-wheel/fire-keeper",
+  "version": "0.2.2",
+  "description": "Fire Keeper coordination agent for Medicine Wheel — tends the ceremony fire, ensures relational integrity through gating conditions, and maintains Wilson alignment as an active agent",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@medicine-wheel/ontology-core": "^0.2.2",
+    "@medicine-wheel/ceremony-protocol": "^0.2.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "fire-keeper",
+    "ceremony",
+    "governance",
+    "indigenous",
+    "wilson",
+    "relational-accountability"
+  ],
+  "license": "MIT"
+}