@medicine-wheel/narrative-engine 0.2.2

package/dist/rsis-narrative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsis-narrative.d.ts","sourceRoot":"","sources":["../src/rsis-narrative.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAEpB,qBAAqB,EACrB,OAAO,EACR,MAAM,+BAA+B,CAAC;AAGvC;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,EAAE,EAC/B,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAChC,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,MAAM,CAYR;AAMD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,qBAAqB,EACnC,KAAK,EAAE,MAAM,GACZ,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAarE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEhD"}

package/dist/rsis-narrative.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * @medicine-wheel/narrative-engine — RSIS Narrative Generators
+ *
+ * Produces ceremony-phase-aware provenance stories, reciprocity
+ * narratives, and directional observations for RSIS tool outputs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateProvenanceNarrative = generateProvenanceNarrative;
+exports.generateReciprocityObservation = generateReciprocityObservation;
+exports.generateDirectionObservation = generateDirectionObservation;
+exports.getCeremonyPhaseFraming = getCeremonyPhaseFraming;
+exports.describeSun = describeSun;
+const ontology_core_1 = require("@medicine-wheel/ontology-core");
+/**
+ * Generate a human-readable provenance narrative for a code artifact
+ */
+function generateProvenanceNarrative(symbolName, lineage, inquiries, stewards) {
+    let narrative = `"${symbolName}" `;
+    if (lineage.length > 0) {
+        const first = lineage[0];
+        narrative += `was born in the ${first.sun || 'Unknown'} Sun during cycle ${first.cycle || 'unknown'}`;
+        if (lineage.length > 1) {
+            const last = lineage[lineage.length - 1];
+            narrative += `, most recently touched under ${last.sun || 'Unknown'} during cycle ${last.cycle || 'unknown'}`;
+        }
+        narrative += '.';
+    }
+    else {
+        narrative += 'has no recorded ceremonial lineage yet.';
+    }
+    if (inquiries.length > 0) {
+        narrative += ` It serves ${inquiries.length} ${inquiries.length === 1 ? 'inquiry' : 'inquiries'}: ${inquiries.map(i => i.name).join(', ')}.`;
+    }
+    if (stewards.length > 0) {
+        narrative += ` Stewarded by: ${stewards.map(s => s.name).join(', ')}.`;
+    }
+    return narrative;
+}
+/**
+ * Generate a reciprocity observation — always invitational, never evaluative
+ */
+function generateReciprocityObservation(stewardCount, flowCount) {
+    const parts = [];
+    if (flowCount === 0 && stewardCount === 0) {
+        return 'No reciprocity data has been populated yet. Consider running rsis-gitnexus analyze with RSIS mode enabled.';
+    }
+    if (stewardCount > 0) {
+        parts.push(`${stewardCount} steward(s) identified. This area invites reflection on how stewardship is distributed.`);
+    }
+    if (flowCount > 0) {
+        parts.push(`${flowCount} reciprocity flow(s) identified. This area invites reflection on how contributions move.`);
+    }
+    return parts.join(' ');
+}
+const DIRECTION_EMOJI = {
+    east: '🌸', south: '🧠', west: '⚡', north: '🕸️',
+};
+/**
+ * Generate a natural language observation about directional balance
+ */
+function generateDirectionObservation(distribution, total) {
+    if (total === 0)
+        return 'No recent changes to analyze.';
+    const entries = Object.entries(distribution);
+    const sorted = entries.sort((a, b) => b[1] - a[1]);
+    const dominant = sorted[0][0];
+    const weakest = sorted[sorted.length - 1][0];
+    return `Recent work is concentrated in ${dominant} ${DIRECTION_EMOJI[dominant]} (${distribution[dominant]}%). ` +
+        `The ecosystem may benefit from a ${weakest} ${DIRECTION_EMOJI[weakest]} ceremony.`;
+}
+/**
+ * Get ceremony-phase-aware framing for tool output
+ */
+function getCeremonyPhaseFraming(phase) {
+    switch (phase) {
+        case 'opening':
+            return 'Opening Phase — What wants to emerge? Focus on intention and vision.';
+        case 'council':
+            return 'Council Phase — Cross-Sun perspectives on code relationships.';
+        case 'integration':
+            return 'Integration Phase — Weaving insights into synthesis artifacts.';
+        case 'closure':
+            return 'Closure Phase — Reciprocity summaries and seeding observations.';
+        default:
+            return '';
+    }
+}
+/**
+ * Describe a Thematic Sun
+ */
+function describeSun(sun) {
+    return ontology_core_1.SUN_DESCRIPTIONS[sun] || sun;
+}
+//# sourceMappingURL=rsis-narrative.js.map

package/dist/rsis-narrative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsis-narrative.js","sourceRoot":"","sources":["../src/rsis-narrative.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAcH,kEAyBC;AAKD,wEAeC;AASD,oEAaC;AAKD,0DAaC;AAKD,kCAEC;AAjGD,iEAAiE;AAEjE;;GAEG;AACH,SAAgB,2BAA2B,CACzC,UAAkB,EAClB,OAA+B,EAC/B,SAAkC,EAClC,QAAiC;IAEjC,IAAI,SAAS,GAAG,IAAI,UAAU,IAAI,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,SAAS,IAAI,mBAAmB,KAAK,CAAC,GAAG,IAAI,SAAS,qBAAqB,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;QACtG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACzC,SAAS,IAAI,iCAAiC,IAAI,CAAC,GAAG,IAAI,SAAS,iBAAiB,IAAI,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;QAChH,CAAC;QACD,SAAS,IAAI,GAAG,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,SAAS,IAAI,yCAAyC,CAAC;IACzD,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,SAAS,IAAI,cAAc,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC/I,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,SAAS,IAAI,kBAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACzE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,8BAA8B,CAC5C,YAAoB,EACpB,SAAiB;IAEjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,4GAA4G,CAAC;IACtH,CAAC;IACD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,yFAAyF,CAAC,CAAC;IACvH,CAAC;IACD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,0FAA0F,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,eAAe,GAAkC;IACrD,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK;CACjD,CAAC;AAEF;;GAEG;AACH,SAAgB,4BAA4B,CAC1C,YAAmC,EACnC,KAAa;IAEb,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,+BAA+B,CAAC;IAExD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAA8B,CAAC;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7C,OAAO,kCAAkC,QAAQ,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC,QAAQ,CAAC,MAAM;QAC7G,oCAAoC,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,KAAqB;IAC3D,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,sEAAsE,CAAC;QAChF,KAAK,SAAS;YACZ,OAAO,+DAA+D,CAAC;QACzE,KAAK,aAAa;YAChB,OAAO,gEAAgE,CAAC;QAC1E,KAAK,SAAS;YACZ,OAAO,iEAAiE,CAAC;QAC3E;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,GAAY;IACtC,OAAO,gCAAgB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;AACtC,CAAC"}

package/dist/sequencer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Beat Sequencer — orders and validates narrative beats
+ * across the four-direction, four-act structure.
+ */
+import type { NarrativeBeat, DirectionName } from '@medicine-wheel/ontology-core';
+import type { BeatPosition, BeatInsertResult, SequencerOptions } from './types.js';
+/** Map beats to their position metadata */
+export declare function sequenceBeats(beats: NarrativeBeat[]): BeatPosition[];
+/** Insert a beat into an existing sequence */
+export declare function insertBeat(beats: NarrativeBeat[], newBeat: NarrativeBeat, opts?: SequencerOptions): BeatInsertResult;
+/** Get beats grouped by direction */
+export declare function beatsByDirection(beats: NarrativeBeat[]): Record<DirectionName, NarrativeBeat[]>;
+/** Get the next expected direction in a cycle */
+export declare function nextDirection(beats: NarrativeBeat[]): DirectionName | null;
+/** Get the current act based on the latest beat */
+export declare function currentAct(beats: NarrativeBeat[]): number;
+/** Suggest the next beat's direction and act */
+export declare function suggestNextBeat(beats: NarrativeBeat[]): {
+    direction: DirectionName;
+    act: number;
+};
+/** Reorder beats by direction spiral (east→south→west→north within each act) */
+export declare function spiralOrder(beats: NarrativeBeat[]): NarrativeBeat[];
+/**
+ * Analyse whether later beats show genuine epistemic deepening vs repetition.
+ *
+ * Deepening is detected when:
+ * - Learnings accumulate and diversify across beats
+ * - Later beats reference or build upon earlier learnings
+ * - New directions are visited in subsequent cycles
+ *
+ * Stagnation is flagged when:
+ * - Learnings stop growing
+ * - The same directions repeat without new content
+ */
+export declare function detectEpistemicDeepening(beats: NarrativeBeat[]): {
+    circleCount: number;
+    deepeningIndicators: string[];
+    stagnationRisk: boolean;
+};
+/**
+ * Identify beats where understanding visibly shifted.
+ *
+ * A transformation point is a beat where:
+ * - New learnings appear that were absent in all prior beats
+ * - A direction transition occurs (ceremony boundary)
+ * - The beat carries ceremonies (indicating intentional shift)
+ */
+export declare function findTransformationPoints(beats: NarrativeBeat[]): Array<{
+    beatId: string;
+    beforeUnderstanding: string;
+    afterUnderstanding: string;
+    catalyst: string;
+}>;
+//# sourceMappingURL=sequencer.d.ts.map

package/dist/sequencer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequencer.d.ts","sourceRoot":"","sources":["../src/sequencer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAElF,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAUnF,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,CAapE;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,gBAAqB,GAC1B,gBAAgB,CA0ClB;AAED,qCAAqC;AACrC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAQ/F;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,GAAG,IAAI,CAQ1E;AAED,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAGzD;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG;IAAE,SAAS,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAOjG;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAQnE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;CACzB,CAyDA;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAwCD"}

package/dist/sequencer.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sequenceBeats = sequenceBeats;
+exports.insertBeat = insertBeat;
+exports.beatsByDirection = beatsByDirection;
+exports.nextDirection = nextDirection;
+exports.currentAct = currentAct;
+exports.suggestNextBeat = suggestNextBeat;
+exports.spiralOrder = spiralOrder;
+exports.detectEpistemicDeepening = detectEpistemicDeepening;
+exports.findTransformationPoints = findTransformationPoints;
+const ontology_core_1 = require("@medicine-wheel/ontology-core");
+const DIRECTION_ORDER = ['east', 'south', 'west', 'north'];
+const DEFAULT_OPTIONS = {
+    enforceDirectionOrder: false,
+    allowMultiplePerAct: true,
+    maxBeatsPerDirection: 12,
+};
+/** Map beats to their position metadata */
+function sequenceBeats(beats) {
+    const sorted = [...beats].sort((a, b) => {
+        const actDiff = a.act - b.act;
+        if (actDiff !== 0)
+            return actDiff;
+        return a.timestamp.localeCompare(b.timestamp);
+    });
+    return sorted.map((beat, index) => ({
+        beat,
+        index,
+        direction: beat.direction,
+        act: beat.act,
+    }));
+}
+/** Insert a beat into an existing sequence */
+function insertBeat(beats, newBeat, opts = {}) {
+    const options = { ...DEFAULT_OPTIONS, ...opts };
+    const warnings = [];
+    // Check max beats per direction
+    const directionCount = beats.filter(b => b.direction === newBeat.direction).length;
+    if (directionCount >= options.maxBeatsPerDirection) {
+        return {
+            success: false,
+            positions: sequenceBeats(beats),
+            warnings: [`Direction '${newBeat.direction}' already has ${directionCount} beats (max: ${options.maxBeatsPerDirection})`],
+        };
+    }
+    // Check multiple per act
+    if (!options.allowMultiplePerAct) {
+        const existingInAct = beats.find(b => b.act === newBeat.act && b.direction === newBeat.direction);
+        if (existingInAct) {
+            return {
+                success: false,
+                positions: sequenceBeats(beats),
+                warnings: [`Act ${newBeat.act} in direction '${newBeat.direction}' already has a beat`],
+            };
+        }
+    }
+    // Check direction order enforcement
+    if (options.enforceDirectionOrder && beats.length > 0) {
+        const lastBeat = beats[beats.length - 1];
+        const lastIdx = DIRECTION_ORDER.indexOf(lastBeat.direction);
+        const newIdx = DIRECTION_ORDER.indexOf(newBeat.direction);
+        if (newIdx < lastIdx) {
+            warnings.push(`Beat in '${newBeat.direction}' precedes the latest '${lastBeat.direction}' — direction order not enforced`);
+        }
+    }
+    const updated = [...beats, newBeat];
+    return {
+        success: true,
+        positions: sequenceBeats(updated),
+        warnings,
+    };
+}
+/** Get beats grouped by direction */
+function beatsByDirection(beats) {
+    const result = {
+        east: [], south: [], west: [], north: [],
+    };
+    for (const beat of beats) {
+        result[beat.direction].push(beat);
+    }
+    return result;
+}
+/** Get the next expected direction in a cycle */
+function nextDirection(beats) {
+    if (beats.length === 0)
+        return 'east';
+    const visited = new Set(beats.map(b => b.direction));
+    for (const dir of DIRECTION_ORDER) {
+        if (!visited.has(dir))
+            return dir;
+    }
+    return null; // all directions visited
+}
+/** Get the current act based on the latest beat */
+function currentAct(beats) {
+    if (beats.length === 0)
+        return 1;
+    return Math.max(...beats.map(b => b.act));
+}
+/** Suggest the next beat's direction and act */
+function suggestNextBeat(beats) {
+    const next = nextDirection(beats);
+    if (next) {
+        return { direction: next, act: ontology_core_1.DIRECTION_ACTS[next] };
+    }
+    // All directions visited — advance to next cycle by restarting at east
+    return { direction: 'east', act: 1 };
+}
+/** Reorder beats by direction spiral (east→south→west→north within each act) */
+function spiralOrder(beats) {
+    return [...beats].sort((a, b) => {
+        const actDiff = a.act - b.act;
+        if (actDiff !== 0)
+            return actDiff;
+        const dirDiff = DIRECTION_ORDER.indexOf(a.direction) - DIRECTION_ORDER.indexOf(b.direction);
+        if (dirDiff !== 0)
+            return dirDiff;
+        return a.timestamp.localeCompare(b.timestamp);
+    });
+}
+// ─── Epistemic Deepening ──────────────────────────────────────
+/**
+ * Analyse whether later beats show genuine epistemic deepening vs repetition.
+ *
+ * Deepening is detected when:
+ * - Learnings accumulate and diversify across beats
+ * - Later beats reference or build upon earlier learnings
+ * - New directions are visited in subsequent cycles
+ *
+ * Stagnation is flagged when:
+ * - Learnings stop growing
+ * - The same directions repeat without new content
+ */
+function detectEpistemicDeepening(beats) {
+    if (beats.length === 0) {
+        return { circleCount: 0, deepeningIndicators: [], stagnationRisk: false };
+    }
+    const sorted = [...beats].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    const indicators = [];
+    // Count full cycles through all four directions
+    let cycleDirections = new Set();
+    let circleCount = 0;
+    for (const beat of sorted) {
+        cycleDirections.add(beat.direction);
+        if (cycleDirections.size === DIRECTION_ORDER.length) {
+            circleCount++;
+            cycleDirections = new Set();
+        }
+    }
+    // Track learning accumulation
+    const cumulativeLearnings = [];
+    let learningsGrowing = false;
+    const midpoint = Math.floor(sorted.length / 2);
+    const firstHalfLearnings = sorted.slice(0, midpoint).flatMap(b => b.learnings);
+    const secondHalfLearnings = sorted.slice(midpoint).flatMap(b => b.learnings);
+    if (secondHalfLearnings.length > firstHalfLearnings.length) {
+        learningsGrowing = true;
+        indicators.push('Learnings are accumulating — later beats carry more insight');
+    }
+    // Check learning diversity
+    const allLearnings = sorted.flatMap(b => b.learnings);
+    const uniqueLearnings = new Set(allLearnings);
+    if (uniqueLearnings.size > allLearnings.length * 0.7) {
+        indicators.push('High learning diversity — minimal repetition of insights');
+    }
+    // Check direction coverage expansion
+    const firstHalfDirs = new Set(sorted.slice(0, midpoint).map(b => b.direction));
+    const secondHalfDirs = new Set(sorted.slice(midpoint).map(b => b.direction));
+    if (secondHalfDirs.size >= firstHalfDirs.size) {
+        indicators.push('Direction coverage maintained or expanded in later beats');
+    }
+    if (circleCount > 0) {
+        indicators.push(`${circleCount} full circle(s) completed through all four directions`);
+    }
+    // Stagnation: no learning growth and high repetition
+    const stagnationRisk = !learningsGrowing &&
+        beats.length > 4 &&
+        uniqueLearnings.size < allLearnings.length * 0.5;
+    return { circleCount, deepeningIndicators: indicators, stagnationRisk };
+}
+/**
+ * Identify beats where understanding visibly shifted.
+ *
+ * A transformation point is a beat where:
+ * - New learnings appear that were absent in all prior beats
+ * - A direction transition occurs (ceremony boundary)
+ * - The beat carries ceremonies (indicating intentional shift)
+ */
+function findTransformationPoints(beats) {
+    if (beats.length < 2)
+        return [];
+    const sorted = [...beats].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    const transformations = [];
+    const priorLearnings = new Set();
+    for (let i = 1; i < sorted.length; i++) {
+        const beat = sorted[i];
+        const prev = sorted[i - 1];
+        const newLearnings = beat.learnings.filter((l) => !priorLearnings.has(l));
+        const isDirectionShift = beat.direction !== prev.direction;
+        const hasCeremony = beat.ceremonies.length > 0;
+        const hasNewLearnings = newLearnings.length > 0;
+        if (hasNewLearnings || (isDirectionShift && hasCeremony)) {
+            const catalystParts = [];
+            if (isDirectionShift)
+                catalystParts.push(`direction shift (${prev.direction} → ${beat.direction})`);
+            if (hasCeremony)
+                catalystParts.push('ceremony conducted');
+            if (hasNewLearnings)
+                catalystParts.push(`${newLearnings.length} new learning(s)`);
+            transformations.push({
+                beatId: beat.id,
+                beforeUnderstanding: prev.learnings.join('; ') || prev.title,
+                afterUnderstanding: beat.learnings.join('; ') || beat.title,
+                catalyst: catalystParts.join(', '),
+            });
+        }
+        for (const l of beat.learnings)
+            priorLearnings.add(l);
+    }
+    return transformations;
+}
+//# sourceMappingURL=sequencer.js.map

package/dist/sequencer.js.map

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

package/dist/timeline.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Timeline Builder — generates timeline data for visualization
+ * of narrative beats along chronological, directional, or ceremonial axes.
+ */
+import type { NarrativeBeat, DirectionName } from '@medicine-wheel/ontology-core';
+import type { TimelineData, TimelineOptions } from './types.js';
+/** Build timeline data from narrative beats */
+export declare function buildTimeline(beats: NarrativeBeat[], options?: TimelineOptions): TimelineData;
+/** Get beats grouped into acts for a timeline strip view */
+export declare function actStrip(beats: NarrativeBeat[]): Array<{
+    act: number;
+    direction: DirectionName;
+    beats: NarrativeBeat[];
+    hasCeremony: boolean;
+}>;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAElF,OAAO,KAAK,EAGV,YAAY,EAEZ,eAAe,EAChB,MAAM,YAAY,CAAC;AASpB,+CAA+C;AAC/C,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,GAAE,eAAoB,GAC5B,YAAY,CAyCd;AA6ED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC,CAWD"}

package/dist/timeline.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTimeline = buildTimeline;
+exports.actStrip = actStrip;
+const ontology_core_1 = require("@medicine-wheel/ontology-core");
+const DEFAULT_OPTIONS = {
+    axis: 'chronological',
+    filterDirection: undefined,
+    filterAct: undefined,
+    sortBy: 'timestamp',
+};
+/** Build timeline data from narrative beats */
+function buildTimeline(beats, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Filter
+    let filtered = [...beats];
+    if (opts.filterDirection) {
+        filtered = filtered.filter(b => b.direction === opts.filterDirection);
+    }
+    if (opts.filterAct) {
+        filtered = filtered.filter(b => b.act === opts.filterAct);
+    }
+    // Sort
+    filtered.sort((a, b) => {
+        switch (opts.sortBy) {
+            case 'act':
+                return a.act - b.act || a.timestamp.localeCompare(b.timestamp);
+            case 'direction': {
+                const dirOrder = ['east', 'south', 'west', 'north'];
+                return dirOrder.indexOf(a.direction) - dirOrder.indexOf(b.direction) || a.timestamp.localeCompare(b.timestamp);
+            }
+            default:
+                return a.timestamp.localeCompare(b.timestamp);
+        }
+    });
+    // Build entries
+    const span = computeSpan(filtered);
+    const entries = filtered.map((beat, i) => ({
+        beat,
+        position: filtered.length <= 1 ? 0.5 : i / (filtered.length - 1),
+        direction: beat.direction,
+        act: beat.act,
+        hasCeremony: beat.ceremonies.length > 0,
+        group: groupKey(beat, opts.axis),
+    }));
+    // Build groups
+    const groups = buildGroups(entries, opts.axis);
+    return { axis: opts.axis, entries, groups, span };
+}
+/** Compute the time span of beats */
+function computeSpan(beats) {
+    if (beats.length === 0) {
+        const now = new Date().toISOString();
+        return { start: now, end: now };
+    }
+    const timestamps = beats.map(b => b.timestamp).sort();
+    return { start: timestamps[0], end: timestamps[timestamps.length - 1] };
+}
+/** Determine the group key for a beat */
+function groupKey(beat, axis) {
+    switch (axis) {
+        case 'directional':
+            return beat.direction;
+        case 'ceremonial':
+            return beat.ceremonies.length > 0 ? 'with-ceremony' : 'without-ceremony';
+        default:
+            return `act-${beat.act}`;
+    }
+}
+/** Build group metadata */
+function buildGroups(entries, axis) {
+    const groupMap = new Map();
+    for (const entry of entries) {
+        const existing = groupMap.get(entry.group) ?? [];
+        existing.push(entry);
+        groupMap.set(entry.group, existing);
+    }
+    const groups = [];
+    for (const [key, groupEntries] of groupMap) {
+        groups.push({
+            key,
+            label: groupLabel(key, axis),
+            color: groupColor(key, axis),
+            entries: groupEntries,
+        });
+    }
+    return groups;
+}
+/** Human-readable group label */
+function groupLabel(key, axis) {
+    switch (axis) {
+        case 'directional':
+            return key.charAt(0).toUpperCase() + key.slice(1);
+        case 'ceremonial':
+            return key === 'with-ceremony' ? 'With Ceremony' : 'Without Ceremony';
+        default:
+            return `Act ${key.replace('act-', '')}`;
+    }
+}
+/** Group color */
+function groupColor(key, axis) {
+    switch (axis) {
+        case 'directional':
+            return ontology_core_1.DIRECTION_COLORS[key] ?? '#888';
+        case 'ceremonial':
+            return key === 'with-ceremony' ? '#DC143C' : '#666';
+        default: {
+            const actColors = {
+                'act-1': ontology_core_1.DIRECTION_COLORS.east,
+                'act-2': ontology_core_1.DIRECTION_COLORS.south,
+                'act-3': ontology_core_1.DIRECTION_COLORS.west,
+                'act-4': ontology_core_1.DIRECTION_COLORS.north,
+            };
+            return actColors[key] ?? '#888';
+        }
+    }
+}
+/** Get beats grouped into acts for a timeline strip view */
+function actStrip(beats) {
+    const dirOrder = ['east', 'south', 'west', 'north'];
+    return dirOrder.map((dir, i) => {
+        const actBeats = beats.filter(b => b.direction === dir);
+        return {
+            act: i + 1,
+            direction: dir,
+            beats: actBeats.sort((a, b) => a.timestamp.localeCompare(b.timestamp)),
+            hasCeremony: actBeats.some(b => b.ceremonies.length > 0),
+        };
+    });
+}
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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