medicine-wheel-fire-keeper 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# 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
+
+```typescript
+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

package/dist/ceremony-state.d.ts

@@ -0,0 +1,63 @@
+/**
+ * medicine-wheel-fire-keeper — Extended Ceremony State Management
+ *
+ * Manages the full lifecycle of ceremony state with extended phases:
+ * gathering → kindling → tending → harvesting → resting.
+ * Tracks quadrant status and detects completion readiness.
+ */
+import type { DirectionName } from 'medicine-wheel-ontology-core';
+import type { CeremonyPhaseExtended, CeremonyStateExtended, QuadrantStatus } from './types.js';
+/** Manages extended ceremony state transitions and quadrant tracking */
+export declare class CeremonyStateManager {
+    private state;
+    constructor(state: CeremonyStateExtended);
+    /** Get the current ceremony state (immutable copy) */
+    getState(): CeremonyStateExtended;
+    /**
+     * Transition to the next ceremony phase with validation.
+     * Phases must proceed in order: gathering → kindling → tending → harvesting → resting.
+     * @returns The new phase, or null if transition is invalid
+     */
+    transitionPhase(): CeremonyPhaseExtended | null;
+    /**
+     * Update the status of a quadrant.
+     * @param direction - The direction to update
+     * @param updates - Partial quadrant status updates
+     */
+    updateQuadrant(direction: DirectionName, updates: Partial<QuadrantStatus>): void;
+    /**
+     * Check if a relational circle is complete — all four quadrants visited.
+     * A quadrant counts as visited when its status is 'visited' or 'complete'
+     * and its deepest circle depth is >= 1.
+     */
+    checkCircleComplete(): boolean;
+    /**
+     * Detect whether the ceremony is ready to transition to the next phase.
+     * Evaluates gating conditions, quadrant coverage, and trajectory health.
+     */
+    detectCompletionReadiness(): CompletionReadiness;
+    private validateTransition;
+    private computeCurrentConfidence;
+}
+/** Assessment of ceremony completion readiness */
+export interface CompletionReadiness {
+    /** Whether the ceremony is ready to advance */
+    ready: boolean;
+    /** Whether a full relational circle has been completed */
+    circleComplete: boolean;
+    /** Whether all gating conditions are satisfied */
+    gatesOk: boolean;
+    /** Whether trajectory confidence is acceptable */
+    trajectoryOk: boolean;
+    /** Whether all relational milestones are complete */
+    milestonesComplete: boolean;
+    /** List of blocking reasons */
+    blockers: string[];
+}
+/**
+ * Create a fresh extended ceremony state for a new inquiry.
+ * @param inquiryRef - Reference to the inquiry
+ * @param startDirection - Initial direction (default: east)
+ */
+export declare function createCeremonyState(inquiryRef: string, startDirection?: DirectionName): CeremonyStateExtended;
+//# sourceMappingURL=ceremony-state.d.ts.map

package/dist/ceremony-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ceremony-state.d.ts","sourceRoot":"","sources":["../src/ceremony-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EAEf,MAAM,YAAY,CAAC;AAcpB,wEAAwE;AACxE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAwB;gBAEzB,KAAK,EAAE,qBAAqB;IAIxC,sDAAsD;IACtD,QAAQ,IAAI,qBAAqB;IAIjC;;;;OAIG;IACH,eAAe,IAAI,qBAAqB,GAAG,IAAI;IAuB/C;;;;OAIG;IACH,cAAc,CACZ,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,IAAI;IASP;;;;OAIG;IACH,mBAAmB,IAAI,OAAO;IAW9B;;;OAGG;IACH,yBAAyB,IAAI,mBAAmB;IA4BhD,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,wBAAwB;CAKjC;AAID,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,cAAc,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,aAAsB,GACrC,qBAAqB,CAsBvB"}

package/dist/ceremony-state.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * medicine-wheel-fire-keeper — Extended Ceremony State Management
+ *
+ * Manages the full lifecycle of ceremony state with extended phases:
+ * gathering → kindling → tending → harvesting → resting.
+ * Tracks quadrant status and detects completion readiness.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CeremonyStateManager = void 0;
+exports.createCeremonyState = createCeremonyState;
+// ── Phase Order ─────────────────────────────────────────────────────────────
+const EXTENDED_PHASE_ORDER = [
+    'gathering',
+    'kindling',
+    'tending',
+    'harvesting',
+    'resting',
+];
+// ── Ceremony State Manager ──────────────────────────────────────────────────
+/** Manages extended ceremony state transitions and quadrant tracking */
+class CeremonyStateManager {
+    state;
+    constructor(state) {
+        this.state = { ...state };
+    }
+    /** Get the current ceremony state (immutable copy) */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Transition to the next ceremony phase with validation.
+     * Phases must proceed in order: gathering → kindling → tending → harvesting → resting.
+     * @returns The new phase, or null if transition is invalid
+     */
+    transitionPhase() {
+        const currentIdx = EXTENDED_PHASE_ORDER.indexOf(this.state.ceremonyPhase);
+        if (currentIdx < 0 || currentIdx >= EXTENDED_PHASE_ORDER.length - 1) {
+            return null;
+        }
+        if (!this.validateTransition(this.state.ceremonyPhase)) {
+            return null;
+        }
+        const nextPhase = EXTENDED_PHASE_ORDER[currentIdx + 1];
+        this.state.ceremonyPhase = nextPhase;
+        this.state.trajectoryHistory.push({
+            timestamp: new Date().toISOString(),
+            confidence: this.computeCurrentConfidence(),
+            direction: this.state.activeDirection,
+            note: `Phase transition: ${EXTENDED_PHASE_ORDER[currentIdx]} → ${nextPhase}`,
+        });
+        return nextPhase;
+    }
+    /**
+     * Update the status of a quadrant.
+     * @param direction - The direction to update
+     * @param updates - Partial quadrant status updates
+     */
+    updateQuadrant(direction, updates) {
+        const current = this.state.quadrantState[direction];
+        this.state.quadrantState[direction] = { ...current, ...updates };
+        if (updates.status === 'active') {
+            this.state.activeDirection = direction;
+        }
+    }
+    /**
+     * Check if a relational circle is complete — all four quadrants visited.
+     * A quadrant counts as visited when its status is 'visited' or 'complete'
+     * and its deepest circle depth is >= 1.
+     */
+    checkCircleComplete() {
+        const directions = ['east', 'south', 'west', 'north'];
+        return directions.every((d) => {
+            const q = this.state.quadrantState[d];
+            return ((q.status === 'visited' || q.status === 'complete' || q.status === 'active') &&
+                q.deepestCircle >= 1);
+        });
+    }
+    /**
+     * Detect whether the ceremony is ready to transition to the next phase.
+     * Evaluates gating conditions, quadrant coverage, and trajectory health.
+     */
+    detectCompletionReadiness() {
+        const gatesOk = this.state.gatingConditions.every((g) => g.satisfied);
+        const circleComplete = this.checkCircleComplete();
+        const trajectoryOk = this.computeCurrentConfidence() >= 0.65;
+        const milestonesComplete = this.state.relationalMilestones.every((m) => m.complete);
+        const ready = gatesOk && trajectoryOk;
+        const reasons = [];
+        if (!gatesOk)
+            reasons.push('Not all gating conditions satisfied');
+        if (!circleComplete)
+            reasons.push('Relational circle not complete');
+        if (!trajectoryOk)
+            reasons.push('Trajectory confidence below threshold');
+        if (!milestonesComplete)
+            reasons.push('Relational milestones incomplete');
+        return {
+            ready,
+            circleComplete,
+            gatesOk,
+            trajectoryOk,
+            milestonesComplete,
+            blockers: reasons,
+        };
+    }
+    // ── Private Helpers ─────────────────────────────────────────────────────
+    validateTransition(currentPhase) {
+        switch (currentPhase) {
+            case 'gathering':
+                // Foundational gating conditions must be satisfied
+                return this.state.gatingConditions.some((g) => g.satisfied);
+            case 'kindling':
+                // Vision units must have some depth
+                return this.state.quadrantState.east.deepestCircle >= 1;
+            case 'tending':
+                // Active work being refined
+                return this.computeCurrentConfidence() >= 0.5;
+            case 'harvesting':
+                // Key units should have completed circles
+                return this.checkCircleComplete() || this.computeCurrentConfidence() >= 0.7;
+            default:
+                return false;
+        }
+    }
+    computeCurrentConfidence() {
+        const history = this.state.trajectoryHistory;
+        if (history.length === 0)
+            return 0.5;
+        return history[history.length - 1].confidence;
+    }
+}
+exports.CeremonyStateManager = CeremonyStateManager;
+/**
+ * Create a fresh extended ceremony state for a new inquiry.
+ * @param inquiryRef - Reference to the inquiry
+ * @param startDirection - Initial direction (default: east)
+ */
+function createCeremonyState(inquiryRef, startDirection = 'east') {
+    const emptyQuadrant = {
+        status: 'pending',
+        unitCount: 0,
+        deepestCircle: 0,
+        lastVisited: null,
+    };
+    return {
+        inquiryRef,
+        ceremonyPhase: 'gathering',
+        activeDirection: startDirection,
+        quadrantState: {
+            east: { ...emptyQuadrant },
+            south: { ...emptyQuadrant },
+            west: { ...emptyQuadrant },
+            north: { ...emptyQuadrant },
+        },
+        gatingConditions: [],
+        relationalMilestones: [],
+        trajectoryHistory: [],
+    };
+}
+//# sourceMappingURL=ceremony-state.js.map

package/dist/ceremony-state.js.map

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

package/dist/check-back.d.ts

@@ -0,0 +1,43 @@
+/**
+ * medicine-wheel-fire-keeper — Relational Check-Back Protocol
+ *
+ * Four-step verification that runs before any autonomous action.
+ * Ensures every action strengthens the relational web rather than
+ * degrading it. Rooted in Wilson's relational accountability framework.
+ */
+import type { FireKeeperContext } from './types.js';
+/** Result of a single check-back step */
+export interface CheckBackStep {
+    /** Step number (1–4) */
+    step: number;
+    /** Human-readable question for this step */
+    question: string;
+    /** Whether this step passed */
+    passed: boolean;
+    /** Explanation of the assessment */
+    reason: string;
+}
+/** Full result of the relational check-back protocol */
+export interface CheckBackResult {
+    /** Whether the action is approved to proceed */
+    approved: boolean;
+    /** Results of all four steps */
+    steps: CheckBackStep[];
+    /** Summary of the check-back */
+    summary: string;
+}
+/**
+ * Execute the four-step relational check-back protocol.
+ * Before any autonomous action, verify it strengthens the relational web.
+ *
+ * Step 1: Does this action honor existing relations?
+ * Step 2: Does it strengthen the Spirit-Body relationship of the project?
+ * Step 3: Is it accountable to all four directions?
+ * Step 4: Would an Elder approve?
+ *
+ * @param action - Description of the proposed action
+ * @param context - Current Fire Keeper context
+ * @returns Check-back result with per-step assessments
+ */
+export declare function relationalCheckBack(action: string, context: FireKeeperContext): CheckBackResult;
+//# sourceMappingURL=check-back.d.ts.map

package/dist/check-back.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-back.d.ts","sourceRoot":"","sources":["../src/check-back.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,eAAe,CAgBjB"}

package/dist/check-back.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * medicine-wheel-fire-keeper — Relational Check-Back Protocol
+ *
+ * Four-step verification that runs before any autonomous action.
+ * Ensures every action strengthens the relational web rather than
+ * degrading it. Rooted in Wilson's relational accountability framework.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relationalCheckBack = relationalCheckBack;
+// ── Check-Back Protocol ─────────────────────────────────────────────────────
+/**
+ * Execute the four-step relational check-back protocol.
+ * Before any autonomous action, verify it strengthens the relational web.
+ *
+ * Step 1: Does this action honor existing relations?
+ * Step 2: Does it strengthen the Spirit-Body relationship of the project?
+ * Step 3: Is it accountable to all four directions?
+ * Step 4: Would an Elder approve?
+ *
+ * @param action - Description of the proposed action
+ * @param context - Current Fire Keeper context
+ * @returns Check-back result with per-step assessments
+ */
+function relationalCheckBack(action, context) {
+    const steps = [
+        checkHonorsRelations(action, context),
+        checkSpiritBodyRelationship(action, context),
+        checkFourDirections(action, context),
+        checkElderApproval(action, context),
+    ];
+    const approved = steps.every((s) => s.passed);
+    const failedSteps = steps.filter((s) => !s.passed);
+    const summary = approved
+        ? `Action "${action}" passes all four check-back steps — proceed with care`
+        : `Action "${action}" failed ${failedSteps.length} check-back step(s): ${failedSteps.map((s) => `Step ${s.step}`).join(', ')}`;
+    return { approved, steps, summary };
+}
+// ── Individual Steps ────────────────────────────────────────────────────────
+/**
+ * Step 1: Does this action honor existing relations?
+ * Checks that gating conditions reflecting relational commitments are met.
+ */
+function checkHonorsRelations(action, context) {
+    const unsatisfied = context.ceremonyState.gatingConditions.filter((g) => !g.satisfied);
+    const passed = unsatisfied.length === 0;
+    return {
+        step: 1,
+        question: 'Does this action honor existing relations?',
+        passed,
+        reason: passed
+            ? 'All relational gating conditions are satisfied'
+            : `${unsatisfied.length} gating condition(s) unsatisfied: ${unsatisfied.map((g) => g.condition).join('; ')}`,
+    };
+}
+/**
+ * Step 2: Does it strengthen the Spirit-Body relationship?
+ * Checks trajectory confidence — a declining trajectory suggests
+ * the action may disconnect vision (Spirit) from implementation (Body).
+ */
+function checkSpiritBodyRelationship(action, context) {
+    const history = context.ceremonyState.trajectoryHistory;
+    if (history.length < 2) {
+        return {
+            step: 2,
+            question: 'Does it strengthen the Spirit-Body relationship of the project?',
+            passed: true,
+            reason: 'Insufficient trajectory history — proceeding with trust',
+        };
+    }
+    const recent = history.slice(-3);
+    const trend = recent[recent.length - 1].confidence - recent[0].confidence;
+    const passed = trend >= -0.1;
+    return {
+        step: 2,
+        question: 'Does it strengthen the Spirit-Body relationship of the project?',
+        passed,
+        reason: passed
+            ? `Trajectory trend is stable or improving (${trend >= 0 ? '+' : ''}${trend.toFixed(2)})`
+            : `Trajectory is declining (${trend.toFixed(2)}) — Spirit-Body relationship may be weakening`,
+    };
+}
+/**
+ * Step 3: Is it accountable to all four directions?
+ * Checks that the ceremony hasn't become stuck in a single quadrant.
+ */
+function checkFourDirections(action, context) {
+    const { quadrantState } = context.ceremonyState;
+    const directions = Object.keys(quadrantState);
+    const activeOrVisited = directions.filter((d) => quadrantState[d].status !== 'pending');
+    // During gathering/kindling, we don't expect all directions yet
+    const earlyPhase = ['gathering', 'kindling'].includes(context.ceremonyState.ceremonyPhase);
+    if (earlyPhase) {
+        return {
+            step: 3,
+            question: 'Is it accountable to all four directions?',
+            passed: true,
+            reason: `Early ceremony phase (${context.ceremonyState.ceremonyPhase}) — directional balance not yet expected`,
+        };
+    }
+    const passed = activeOrVisited.length >= 2;
+    return {
+        step: 3,
+        question: 'Is it accountable to all four directions?',
+        passed,
+        reason: passed
+            ? `${activeOrVisited.length} direction(s) engaged: ${activeOrVisited.join(', ')}`
+            : 'Work is concentrated in fewer than 2 directions — relational balance at risk',
+    };
+}
+/**
+ * Step 4: Would an Elder approve?
+ * Synthesizes Wilson alignment, OCAP compliance, and ceremony state.
+ * This is the holistic check — if the numbers look right but something
+ * feels wrong, this step catches it.
+ */
+function checkElderApproval(action, context) {
+    const wilsonOk = (context.wilsonAlignment ?? 0) >= 0.5;
+    const ocapOk = context.ocapCompliant !== false;
+    const noStopWork = context.ceremonyState.ceremonyPhase !== 'resting';
+    const passed = wilsonOk && ocapOk && noStopWork;
+    const issues = [];
+    if (!wilsonOk)
+        issues.push(`Wilson alignment too low (${context.wilsonAlignment})`);
+    if (!ocapOk)
+        issues.push('OCAP compliance not verified');
+    if (!noStopWork)
+        issues.push('Ceremony is in resting phase');
+    return {
+        step: 4,
+        question: 'Would an Elder approve?',
+        passed,
+        reason: passed
+            ? 'Wilson alignment, OCAP compliance, and ceremony state all indicate approval'
+            : `Concerns: ${issues.join('; ')}`,
+    };
+}
+//# sourceMappingURL=check-back.js.map

package/dist/check-back.js.map

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

package/dist/decisions.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ */
+import type { FireKeeperContext, PermissionTier, DecisionPointType, DecisionPoint } from './types.js';
+import type { HumanNeededMessage } from './messages.js';
+/** Result of checking whether human involvement is needed */
+export interface HumanDecisionResult {
+    /** Whether human involvement is required */
+    needed: boolean;
+    /** Which decision point was triggered, if any */
+    decisionType: DecisionPointType | null;
+    /** Reason human involvement is needed */
+    reason: string | null;
+}
+/**
+ * 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)
+ */
+export declare function humanNeeded(context: FireKeeperContext, decisionPoints: DecisionPoint[], trajectoryThreshold?: number): HumanDecisionResult;
+/** Result of a permission escalation request */
+export interface EscalationResult {
+    /** Whether escalation is allowed */
+    allowed: boolean;
+    /** Whether human approval is required for this escalation */
+    humanRequired: boolean;
+    /** The tier being escalated from */
+    fromTier: PermissionTier;
+    /** The tier being escalated to */
+    toTier: PermissionTier;
+    /** Reason for the decision */
+    reason: string;
+}
+/**
+ * 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
+ */
+export declare function permissionEscalation(currentTier: PermissionTier, requestedAction: PermissionTier): EscalationResult;
+/** Result of a circle review check */
+export interface CircleReviewResult {
+    /** Whether a circle review should be triggered */
+    reviewNeeded: boolean;
+    /** The human.needed message to send, if review is needed */
+    message: HumanNeededMessage | null;
+}
+/**
+ * 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
+ */
+export declare function circleReview(context: FireKeeperContext): CircleReviewResult;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAWxD,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,yCAAyC;IACzC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,iBAAiB,EAC1B,cAAc,EAAE,aAAa,EAAE,EAC/B,mBAAmB,GAAE,MAAa,GACjC,mBAAmB,CA0BrB;AAID,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,aAAa,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,QAAQ,EAAE,cAAc,CAAC;IACzB,kCAAkC;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,cAAc,EAC3B,eAAe,EAAE,cAAc,GAC9B,gBAAgB,CAyBlB;AAID,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB,CAgC3E"}