@medicine-wheel/fire-keeper 0.2.2

package/dist/decisions.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * @medicine-wheel/fire-keeper — Human-in-the-Loop Decisions
+ *
+ * Determines when human involvement is required, manages permission
+ * escalation, and triggers circle review processes. The Fire Keeper
+ * decides autonomously except at defined decision points.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.humanNeeded = humanNeeded;
+exports.permissionEscalation = permissionEscalation;
+exports.circleReview = circleReview;
+// ── Permission Tier Ordering ────────────────────────────────────────────────
+const TIER_ORDER = ['observe', 'analyze', 'propose', 'act'];
+/** Tiers that require human approval */
+const HUMAN_REQUIRED_TIERS = ['act'];
+/**
+ * Determine if a human decision is required given the current context.
+ * Checks trajectory confidence, value divergence, and decision point triggers.
+ * @param context - Current Fire Keeper context
+ * @param decisionPoints - Configured decision points to check
+ * @param trajectoryThreshold - Minimum acceptable trajectory confidence (default: 0.65)
+ */
+function humanNeeded(context, decisionPoints, trajectoryThreshold = 0.65) {
+    // Check trajectory confidence
+    const history = context.ceremonyState.trajectoryHistory;
+    if (history.length > 0) {
+        const latest = history[history.length - 1];
+        if (latest.confidence < trajectoryThreshold) {
+            return {
+                needed: true,
+                decisionType: 'value-conflict',
+                reason: `Trajectory confidence (${latest.confidence}) below threshold (${trajectoryThreshold})`,
+            };
+        }
+    }
+    // Check configured decision points
+    for (const dp of decisionPoints) {
+        if (dp.requiresHuman && dp.trigger(context)) {
+            return {
+                needed: true,
+                decisionType: dp.type,
+                reason: `Decision point triggered: ${dp.type}`,
+            };
+        }
+    }
+    return { needed: false, decisionType: null, reason: null };
+}
+/**
+ * Evaluate a permission escalation request.
+ * The 'act' tier always requires human approval.
+ * @param currentTier - Agent's current permission tier
+ * @param requestedAction - The action the agent wants to perform
+ */
+function permissionEscalation(currentTier, requestedAction) {
+    const currentIdx = TIER_ORDER.indexOf(currentTier);
+    const requestedIdx = TIER_ORDER.indexOf(requestedAction);
+    if (requestedIdx <= currentIdx) {
+        return {
+            allowed: true,
+            humanRequired: false,
+            fromTier: currentTier,
+            toTier: requestedAction,
+            reason: 'Requested action is within current permission tier',
+        };
+    }
+    const humanRequired = HUMAN_REQUIRED_TIERS.includes(requestedAction);
+    return {
+        allowed: !humanRequired,
+        humanRequired,
+        fromTier: currentTier,
+        toTier: requestedAction,
+        reason: humanRequired
+            ? `Escalation to '${requestedAction}' tier requires human approval`
+            : `Escalation from '${currentTier}' to '${requestedAction}' permitted`,
+    };
+}
+/**
+ * Trigger a circle review process when an ImportanceUnit reaches
+ * circle completion (all four quadrants visited). Human must confirm
+ * before the unit can be archived or pruned.
+ * @param context - Current Fire Keeper context
+ */
+function circleReview(context) {
+    const milestones = context.ceremonyState.relationalMilestones;
+    const completeMilestones = milestones.filter((m) => m.quadrantsTouched.length >= m.quadrantsRequired.length &&
+        !m.complete);
+    if (completeMilestones.length === 0) {
+        return { reviewNeeded: false, message: null };
+    }
+    const milestone = completeMilestones[0];
+    const requestId = `review-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    return {
+        reviewNeeded: true,
+        message: {
+            type: 'human.needed',
+            payload: {
+                requestId,
+                reason: `Relational circle complete: "${milestone.milestone}" — all quadrants visited`,
+                decisionType: 'circle-completion-review',
+                context: {
+                    unitId: context.unitId,
+                    summary: `Milestone "${milestone.milestone}" has touched all required quadrants: ${milestone.quadrantsTouched.join(', ')}. Human confirmation needed before archival.`,
+                    options: ['approve-archive', 'request-deepening', 'continue-tending'],
+                },
+                suggestedModality: 'protocol',
+            },
+        },
+    };
+}
+//# sourceMappingURL=decisions.js.map

package/dist/decisions.js.map

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

package/dist/gating.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @medicine-wheel/fire-keeper — Gate Evaluation
+ *
+ * Evaluates gating conditions that must be satisfied before ceremony
+ * work can proceed. Implements Wilson's relational accountability
+ * as active gates rather than passive metrics.
+ */
+import type { GatingCondition, GatingConditionStatus, FireKeeperContext } from './types.js';
+/** Result of evaluating all gating conditions */
+export interface GateEvaluationResult {
+    /** Whether all required gates are satisfied */
+    allSatisfied: boolean;
+    /** Status of each individual gate */
+    statuses: GatingConditionStatus[];
+    /** Conditions that are not yet satisfied */
+    unsatisfied: GatingConditionStatus[];
+}
+/**
+ * Evaluate all gating conditions against the current context.
+ * Returns detailed status of each gate and whether all required gates pass.
+ */
+export declare function evaluateGates(conditions: GatingCondition[], context: FireKeeperContext): GateEvaluationResult;
+/**
+ * Create a new gating condition with a custom evaluator.
+ * @param condition - Human-readable description
+ * @param evaluator - Function that checks whether the condition is met
+ * @param required - Whether the condition is mandatory (default: true)
+ */
+export declare function createGate(condition: string, evaluator: (context: FireKeeperContext) => boolean, required?: boolean): GatingCondition;
+/**
+ * Resolve a held gate by updating its status in the ceremony state.
+ * @param gateStatuses - Current gating condition statuses
+ * @param gateCondition - The condition string to resolve
+ * @param resolvedBy - Who/what resolved the gate
+ * @returns Updated gating condition statuses
+ */
+export declare function resolveHold(gateStatuses: GatingConditionStatus[], gateCondition: string, resolvedBy: string): GatingConditionStatus[];
+/**
+ * Wilson alignment threshold gate.
+ * Blocks when Wilson alignment score drops below the configured threshold.
+ */
+export declare const GATE_WILSON_ALIGNMENT: GatingCondition;
+/**
+ * OCAP compliance gate.
+ * Blocks when OCAP® compliance has not been verified.
+ */
+export declare const GATE_OCAP_COMPLIANCE: GatingCondition;
+/**
+ * Ceremony phase appropriateness gate.
+ * Blocks when the ceremony is in a resting phase (no active work allowed).
+ */
+export declare const GATE_CEREMONY_PHASE: GatingCondition;
+/** All default gating conditions */
+export declare const DEFAULT_GATES: GatingCondition[];
+//# sourceMappingURL=gating.d.ts.map

package/dist/gating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gating.d.ts","sourceRoot":"","sources":["../src/gating.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,4CAA4C;IAC5C,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,EAAE,iBAAiB,GACzB,oBAAoB,CAkBtB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,EAClD,QAAQ,GAAE,OAAc,GACvB,eAAe,CAEjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,qBAAqB,EAAE,EACrC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,qBAAqB,EAAE,CAazB;AAID;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAInC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAIlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAIjC,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,aAAa,EAAE,eAAe,EAI1C,CAAC"}

package/dist/gating.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * @medicine-wheel/fire-keeper — Gate Evaluation
+ *
+ * Evaluates gating conditions that must be satisfied before ceremony
+ * work can proceed. Implements Wilson's relational accountability
+ * as active gates rather than passive metrics.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_GATES = exports.GATE_CEREMONY_PHASE = exports.GATE_OCAP_COMPLIANCE = exports.GATE_WILSON_ALIGNMENT = void 0;
+exports.evaluateGates = evaluateGates;
+exports.createGate = createGate;
+exports.resolveHold = resolveHold;
+// ── Gate Evaluation ─────────────────────────────────────────────────────────
+/**
+ * Evaluate all gating conditions against the current context.
+ * Returns detailed status of each gate and whether all required gates pass.
+ */
+function evaluateGates(conditions, context) {
+    const now = new Date().toISOString();
+    const statuses = conditions.map((gate) => {
+        const satisfied = gate.evaluator(context);
+        return {
+            condition: gate.condition,
+            satisfied,
+            satisfiedAt: satisfied ? now : null,
+            satisfiedBy: satisfied ? 'fire-keeper' : null,
+        };
+    });
+    const unsatisfied = statuses.filter((s) => !s.satisfied);
+    const allSatisfied = conditions
+        .filter((c) => c.required)
+        .every((c) => c.evaluator(context));
+    return { allSatisfied, statuses, unsatisfied };
+}
+/**
+ * Create a new gating condition with a custom evaluator.
+ * @param condition - Human-readable description
+ * @param evaluator - Function that checks whether the condition is met
+ * @param required - Whether the condition is mandatory (default: true)
+ */
+function createGate(condition, evaluator, required = true) {
+    return { condition, required, evaluator };
+}
+/**
+ * Resolve a held gate by updating its status in the ceremony state.
+ * @param gateStatuses - Current gating condition statuses
+ * @param gateCondition - The condition string to resolve
+ * @param resolvedBy - Who/what resolved the gate
+ * @returns Updated gating condition statuses
+ */
+function resolveHold(gateStatuses, gateCondition, resolvedBy) {
+    const now = new Date().toISOString();
+    return gateStatuses.map((status) => {
+        if (status.condition === gateCondition && !status.satisfied) {
+            return {
+                ...status,
+                satisfied: true,
+                satisfiedAt: now,
+                satisfiedBy: resolvedBy,
+            };
+        }
+        return status;
+    });
+}
+// ── Default Gates ───────────────────────────────────────────────────────────
+/**
+ * Wilson alignment threshold gate.
+ * Blocks when Wilson alignment score drops below the configured threshold.
+ */
+exports.GATE_WILSON_ALIGNMENT = createGate('Wilson alignment above threshold', (context) => (context.wilsonAlignment ?? 0) >= 0.65, true);
+/**
+ * OCAP compliance gate.
+ * Blocks when OCAP® compliance has not been verified.
+ */
+exports.GATE_OCAP_COMPLIANCE = createGate('OCAP compliance verified', (context) => context.ocapCompliant === true, true);
+/**
+ * Ceremony phase appropriateness gate.
+ * Blocks when the ceremony is in a resting phase (no active work allowed).
+ */
+exports.GATE_CEREMONY_PHASE = createGate('Ceremony phase allows active work', (context) => context.ceremonyState.ceremonyPhase !== 'resting', true);
+/** All default gating conditions */
+exports.DEFAULT_GATES = [
+    exports.GATE_WILSON_ALIGNMENT,
+    exports.GATE_OCAP_COMPLIANCE,
+    exports.GATE_CEREMONY_PHASE,
+];
+//# sourceMappingURL=gating.js.map

package/dist/gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gating.js","sourceRoot":"","sources":["../src/gating.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA0BH,sCAqBC;AAQD,gCAMC;AASD,kCAiBC;AAnED,+EAA+E;AAE/E;;;GAGG;AACH,SAAgB,aAAa,CAC3B,UAA6B,EAC7B,OAA0B;IAE1B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAA4B,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS;YACT,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;YACnC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI;SAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,UAAU;SAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACzB,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CACxB,SAAiB,EACjB,SAAkD,EAClD,WAAoB,IAAI;IAExB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CACzB,YAAqC,EACrC,aAAqB,EACrB,UAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACjC,IAAI,MAAM,CAAC,SAAS,KAAK,aAAa,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5D,OAAO;gBACL,GAAG,MAAM;gBACT,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,GAAG;gBAChB,WAAW,EAAE,UAAU;aACxB,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAE/E;;;GAGG;AACU,QAAA,qBAAqB,GAAoB,UAAU,CAC9D,kCAAkC,EAClC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC,IAAI,IAAI,EACnD,IAAI,CACL,CAAC;AAEF;;;GAGG;AACU,QAAA,oBAAoB,GAAoB,UAAU,CAC7D,0BAA0B,EAC1B,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,KAAK,IAAI,EAC3C,IAAI,CACL,CAAC;AAEF;;;GAGG;AACU,QAAA,mBAAmB,GAAoB,UAAU,CAC5D,mCAAmC,EACnC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,KAAK,SAAS,EAC9D,IAAI,CACL,CAAC;AAEF,oCAAoC;AACvB,QAAA,aAAa,GAAsB;IAC9C,6BAAqB;IACrB,4BAAoB;IACpB,2BAAmB;CACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @medicine-wheel/fire-keeper
+ *
+ * The 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.
+ *
+ * The Fire Keeper does not write code or produce artifacts directly.
+ * It receives, evaluates, routes, and gates the work of sub-agents.
+ *
+ * @packageDocumentation
+ */
+export type { CeremonyPhaseExtended, QuadrantStatus, FireKeeperContext, GatingCondition, GatingConditionStatus, PermissionTier, DecisionPointType, DecisionPoint, TrajectoryCheckpoint, RelationalMilestone, StopWorkOrder, CeremonyStateExtended, FireKeeperConfig, FireKeeperState, } from './types.js';
+export type { ImportanceSubmittedMessage, CircleReturnMessage, AgentReportMessage, HumanResponseMessage, ImportanceAcceptedMessage, ImportanceHeldMessage, DeepenRequestedMessage, HumanNeededMessage, CeremonyStateUpdateMessage, StopWorkOrderMessage, FireKeeperMessage, } from './messages.js';
+export { FireKeeper } from './keeper.js';
+export type { ImportanceEvaluationResult, RelationalAlignmentResult } from './keeper.js';
+export { evaluateGates, createGate, resolveHold, GATE_WILSON_ALIGNMENT, GATE_OCAP_COMPLIANCE, GATE_CEREMONY_PHASE, DEFAULT_GATES, } from './gating.js';
+export type { GateEvaluationResult } from './gating.js';
+export { humanNeeded, permissionEscalation, circleReview } from './decisions.js';
+export type { HumanDecisionResult, EscalationResult, CircleReviewResult, } from './decisions.js';
+export { relationalCheckBack } from './check-back.js';
+export type { CheckBackStep, CheckBackResult } from './check-back.js';
+export { CeremonyStateManager, createCeremonyState } from './ceremony-state.js';
+export type { CompletionReadiness } from './ceremony-state.js';
+export { trajectoryConfidence, valueDivergenceDetect } from './trajectory.js';
+export type { DivergenceResult } from './trajectory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAIpB,YAAY,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAIzF,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAIxD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjF,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAItE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAChF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * @medicine-wheel/fire-keeper
+ *
+ * The 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.
+ *
+ * The Fire Keeper does not write code or produce artifacts directly.
+ * It receives, evaluates, routes, and gates the work of sub-agents.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.valueDivergenceDetect = exports.trajectoryConfidence = exports.createCeremonyState = exports.CeremonyStateManager = exports.relationalCheckBack = exports.circleReview = exports.permissionEscalation = exports.humanNeeded = exports.DEFAULT_GATES = exports.GATE_CEREMONY_PHASE = exports.GATE_OCAP_COMPLIANCE = exports.GATE_WILSON_ALIGNMENT = exports.resolveHold = exports.createGate = exports.evaluateGates = exports.FireKeeper = void 0;
+// ── Fire Keeper ─────────────────────────────────────────────────────────────
+var keeper_js_1 = require("./keeper.js");
+Object.defineProperty(exports, "FireKeeper", { enumerable: true, get: function () { return keeper_js_1.FireKeeper; } });
+// ── Gating ──────────────────────────────────────────────────────────────────
+var gating_js_1 = require("./gating.js");
+Object.defineProperty(exports, "evaluateGates", { enumerable: true, get: function () { return gating_js_1.evaluateGates; } });
+Object.defineProperty(exports, "createGate", { enumerable: true, get: function () { return gating_js_1.createGate; } });
+Object.defineProperty(exports, "resolveHold", { enumerable: true, get: function () { return gating_js_1.resolveHold; } });
+Object.defineProperty(exports, "GATE_WILSON_ALIGNMENT", { enumerable: true, get: function () { return gating_js_1.GATE_WILSON_ALIGNMENT; } });
+Object.defineProperty(exports, "GATE_OCAP_COMPLIANCE", { enumerable: true, get: function () { return gating_js_1.GATE_OCAP_COMPLIANCE; } });
+Object.defineProperty(exports, "GATE_CEREMONY_PHASE", { enumerable: true, get: function () { return gating_js_1.GATE_CEREMONY_PHASE; } });
+Object.defineProperty(exports, "DEFAULT_GATES", { enumerable: true, get: function () { return gating_js_1.DEFAULT_GATES; } });
+// ── Decisions ───────────────────────────────────────────────────────────────
+var decisions_js_1 = require("./decisions.js");
+Object.defineProperty(exports, "humanNeeded", { enumerable: true, get: function () { return decisions_js_1.humanNeeded; } });
+Object.defineProperty(exports, "permissionEscalation", { enumerable: true, get: function () { return decisions_js_1.permissionEscalation; } });
+Object.defineProperty(exports, "circleReview", { enumerable: true, get: function () { return decisions_js_1.circleReview; } });
+// ── Check-Back Protocol ─────────────────────────────────────────────────────
+var check_back_js_1 = require("./check-back.js");
+Object.defineProperty(exports, "relationalCheckBack", { enumerable: true, get: function () { return check_back_js_1.relationalCheckBack; } });
+// ── Ceremony State ──────────────────────────────────────────────────────────
+var ceremony_state_js_1 = require("./ceremony-state.js");
+Object.defineProperty(exports, "CeremonyStateManager", { enumerable: true, get: function () { return ceremony_state_js_1.CeremonyStateManager; } });
+Object.defineProperty(exports, "createCeremonyState", { enumerable: true, get: function () { return ceremony_state_js_1.createCeremonyState; } });
+// ── Trajectory ──────────────────────────────────────────────────────────────
+var trajectory_js_1 = require("./trajectory.js");
+Object.defineProperty(exports, "trajectoryConfidence", { enumerable: true, get: function () { return trajectory_js_1.trajectoryConfidence; } });
+Object.defineProperty(exports, "valueDivergenceDetect", { enumerable: true, get: function () { return trajectory_js_1.valueDivergenceDetect; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAqCH,+EAA+E;AAE/E,yCAAyC;AAAhC,uGAAA,UAAU,OAAA;AAGnB,+EAA+E;AAE/E,yCAQqB;AAPnB,0GAAA,aAAa,OAAA;AACb,uGAAA,UAAU,OAAA;AACV,wGAAA,WAAW,OAAA;AACX,kHAAA,qBAAqB,OAAA;AACrB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA;AACnB,0GAAA,aAAa,OAAA;AAIf,+EAA+E;AAE/E,+CAAiF;AAAxE,2GAAA,WAAW,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAAE,4GAAA,YAAY,OAAA;AAOxD,+EAA+E;AAE/E,iDAAsD;AAA7C,oHAAA,mBAAmB,OAAA;AAG5B,+EAA+E;AAE/E,yDAAgF;AAAvE,yHAAA,oBAAoB,OAAA;AAAE,wHAAA,mBAAmB,OAAA;AAGlD,+EAA+E;AAE/E,iDAA8E;AAArE,qHAAA,oBAAoB,OAAA;AAAE,sHAAA,qBAAqB,OAAA"}

package/dist/keeper.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @medicine-wheel/fire-keeper — Fire Keeper Class
+ *
+ * The core coordination engine. The Fire Keeper tends the ceremony fire,
+ * receives and evaluates ImportanceUnits, gates work through relational
+ * conditions, and issues stop-work orders when accountability is violated.
+ *
+ * The Fire Keeper does not write code or produce artifacts directly.
+ * It receives, evaluates, routes, and gates the work of sub-agents.
+ */
+import type { DirectionName } from '@medicine-wheel/ontology-core';
+import type { FireKeeperConfig, FireKeeperState, CeremonyStateExtended } from './types.js';
+import type { ImportanceAcceptedMessage, ImportanceHeldMessage, DeepenRequestedMessage, StopWorkOrderMessage, HumanNeededMessage } from './messages.js';
+/** Result of evaluating an ImportanceUnit */
+export type ImportanceEvaluationResult = ImportanceAcceptedMessage | ImportanceHeldMessage | DeepenRequestedMessage | HumanNeededMessage;
+/**
+ * The Fire Keeper — ceremony coordination agent.
+ * Tends the fire so the ceremony can proceed with relational integrity.
+ */
+export declare class FireKeeper {
+    private config;
+    private state;
+    private managers;
+    constructor(config: FireKeeperConfig);
+    /** Get the current Fire Keeper state */
+    getState(): FireKeeperState;
+    /**
+     * Begin tending a ceremony for a given inquiry.
+     * @param inquiryRef - Reference to the inquiry
+     * @param startDirection - Initial direction (default: east)
+     */
+    beginCeremony(inquiryRef: string, startDirection?: DirectionName): CeremonyStateExtended;
+    /**
+     * Evaluate an incoming ImportanceUnit against gating conditions,
+     * ceremony state, and relational check-back protocol.
+     * @param unit - The ImportanceUnit payload
+     * @param inquiryRef - Reference to the active inquiry
+     */
+    evaluateImportance(unit: Record<string, unknown>, inquiryRef: string): ImportanceEvaluationResult;
+    /**
+     * Check the current ceremony state for a given inquiry.
+     * @param inquiryRef - Reference to the inquiry
+     */
+    checkCeremonyState(inquiryRef: string): CeremonyStateExtended | null;
+    /**
+     * Request that a participant deepen their work in a specific direction.
+     * @param unitId - The ImportanceUnit to deepen
+     * @param direction - Direction to return to
+     * @param guidance - Guidance for the deepening
+     */
+    requestDeepening(unitId: string, direction: DirectionName, guidance: string): DeepenRequestedMessage;
+    /**
+     * Issue a stop-work order when relational accountability is violated.
+     * This is an emergency halt — the Fire Keeper's most serious action.
+     * @param targetAgentId - Agent to halt
+     * @param reason - Reason for the stop work order
+     * @param unitId - Related ImportanceUnit, if any
+     */
+    issueStopWork(targetAgentId: string, reason: string, unitId?: string | null): StopWorkOrderMessage;
+    /**
+     * Verify Wilson alignment across the current ceremony.
+     * Checks trajectory confidence, gating conditions, and relational milestones.
+     * @param inquiryRef - Reference to the inquiry
+     */
+    checkRelationalAlignment(inquiryRef: string): RelationalAlignmentResult;
+    private buildContext;
+    private estimateWilsonAlignment;
+    private getMissingQuadrants;
+}
+/** Result of a relational alignment check */
+export interface RelationalAlignmentResult {
+    /** Whether the ceremony is relationally aligned */
+    aligned: boolean;
+    /** Current trajectory confidence */
+    confidence: number;
+    /** Issues found during alignment check */
+    issues: string[];
+    /** Unsatisfied gating conditions */
+    unsatisfiedGates?: string[];
+    /** Incomplete relational milestones */
+    incompleteMilestones?: string[];
+    /** Number of active stop-work orders */
+    activeStopWorkOrders?: number;
+}
+//# sourceMappingURL=keeper.d.ts.map

package/dist/keeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper.d.ts","sourceRoot":"","sources":["../src/keeper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,qBAAqB,EAGtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AASvB,6CAA6C;AAC7C,MAAM,MAAM,0BAA0B,GAClC,yBAAyB,GACzB,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,CAAC;AAIvB;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAgD;gBAEpD,MAAM,EAAE,gBAAgB;IAWpC,wCAAwC;IACxC,QAAQ,IAAI,eAAe;IAI3B;;;;OAIG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,aAAsB,GACrC,qBAAqB;IAYxB;;;;;OAKG;IACH,kBAAkB,CAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,GACjB,0BAA0B;IAwF7B;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAIpE;;;;;OAKG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,GACf,sBAAsB;IAYzB;;;;;;OAMG;IACH,aAAa,CACX,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,GAAG,IAAW,GAC3B,oBAAoB;IAsBvB;;;;OAIG;IACH,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,yBAAyB;IAkDvE,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,mBAAmB;CAM5B;AAID,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,wCAAwC;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B"}