@medicine-wheel/narrative-engine 0.2.2

package/README.md

@@ -0,0 +1,72 @@
+# @medicine-wheel/narrative-engine
+
+Beat sequencing, arc validation, cadence patterns, and timeline building for the Medicine Wheel Developer Suite.
+
+## Install
+
+```bash
+npm install @medicine-wheel/narrative-engine
+```
+
+## Modules
+
+### Sequencer
+Order and validate narrative beats across the four-direction, four-act structure.
+
+```ts
+import { sequenceBeats, insertBeat, nextDirection, suggestNextBeat } from '@medicine-wheel/narrative-engine';
+
+const positions = sequenceBeats(beats);
+const suggestion = suggestNextBeat(beats); // { direction: 'west', act: 3 }
+```
+
+### Cadence
+Ceremonial timing rules mapping directions to phases: East→opening, South→deepening, West→integrating, North→closing.
+
+```ts
+import { validateCadence, STANDARD_CADENCE, currentPhase } from '@medicine-wheel/narrative-engine';
+
+const validation = validateCadence(beats, ceremonies, STANDARD_CADENCE);
+console.log(validation.phasesCompleted, validation.violations);
+```
+
+### Arc Validator
+Validate narrative completeness — direction coverage, ceremony presence, Wilson alignment, OCAP® compliance.
+
+```ts
+import { validateArc } from '@medicine-wheel/narrative-engine';
+
+const result = validateArc(beats, ceremonies, relations);
+console.log(result.completeness.completenessScore); // 0–1
+console.log(result.recommendations);
+```
+
+### Timeline
+Generate timeline data for visualization along chronological, directional, or ceremonial axes.
+
+```ts
+import { buildTimeline, actStrip } from '@medicine-wheel/narrative-engine';
+
+const tl = buildTimeline(beats, { axis: 'directional' });
+const strip = actStrip(beats); // 4 acts with beats per direction
+```
+
+### Cycle Manager
+Orchestrate full Medicine Wheel cycles with transition tracking and progress suggestions.
+
+```ts
+import { createCycle, computeProgress } from '@medicine-wheel/narrative-engine';
+
+const cycle = createCycle('c1', 'How do trees teach?');
+const progress = computeProgress(cycle, beats, ceremonies, relations);
+console.log(progress.suggestedAction); // "Move to the west direction (integrating phase)"
+```
+
+## Peer dependency
+
+Requires `@medicine-wheel/ontology-core` ^0.1.0.
+
+## License
+
+MIT
+

package/dist/arc.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Arc Validator — validates narrative completeness and relational integrity
+ * across a full Medicine Wheel cycle.
+ */
+import type { NarrativeBeat, CeremonyLog, Relation } from '@medicine-wheel/ontology-core';
+import type { ArcCompleteness, ArcValidationResult } from './types.js';
+/** Compute the completeness of a narrative arc */
+export declare function computeCompleteness(beats: NarrativeBeat[], ceremonies: CeremonyLog[], relations: Relation[]): ArcCompleteness;
+/** Validate a complete narrative arc */
+export declare function validateArc(beats: NarrativeBeat[], ceremonies: CeremonyLog[], relations: Relation[]): ArcValidationResult;
+/** Quick check: has a cycle visited all four directions? */
+export declare function isArcComplete(beats: NarrativeBeat[]): boolean;
+//# sourceMappingURL=arc.d.ts.map

package/dist/arc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arc.d.ts","sourceRoot":"","sources":["../src/arc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,aAAa,EAGb,WAAW,EACX,QAAQ,EACT,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EACV,eAAe,EAEf,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAIpB,kDAAkD;AAClD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,WAAW,EAAE,EACzB,SAAS,EAAE,QAAQ,EAAE,GACpB,eAAe,CAsCjB;AAcD,wCAAwC;AACxC,wBAAgB,WAAW,CACzB,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,WAAW,EAAE,EACzB,SAAS,EAAE,QAAQ,EAAE,GACpB,mBAAmB,CA0ErB;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAG7D"}

package/dist/arc.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeCompleteness = computeCompleteness;
+exports.validateArc = validateArc;
+exports.isArcComplete = isArcComplete;
+const ontology_core_1 = require("@medicine-wheel/ontology-core");
+const ALL_DIRECTIONS = ['east', 'south', 'west', 'north'];
+/** Compute the completeness of a narrative arc */
+function computeCompleteness(beats, ceremonies, relations) {
+    const directionsVisited = [...new Set(beats.map(b => b.direction))];
+    const directionsMissing = ALL_DIRECTIONS.filter(d => !directionsVisited.includes(d));
+    const beatsPerDirection = { east: 0, south: 0, west: 0, north: 0 };
+    for (const beat of beats) {
+        beatsPerDirection[beat.direction]++;
+    }
+    const ceremoniesPerDirection = { east: 0, south: 0, west: 0, north: 0 };
+    for (const ceremony of ceremonies) {
+        if (ceremony.direction) {
+            ceremoniesPerDirection[ceremony.direction]++;
+        }
+    }
+    // Wilson alignment across all relations
+    const wilsonAlignment = (0, ontology_core_1.aggregateWilsonAlignment)(relations);
+    // OCAP compliance
+    const ocapCompliant = relations.every(r => !r.ocap || (0, ontology_core_1.checkOcapCompliance)(r.ocap).compliant);
+    // Completeness score: weighted average
+    const directionScore = directionsVisited.length / 4;
+    const ceremonyScore = ALL_DIRECTIONS.filter(d => ceremoniesPerDirection[d] > 0).length / 4;
+    const balanceScore = computeBalance(beatsPerDirection);
+    const completenessScore = (directionScore * 0.3) + (ceremonyScore * 0.25) + (wilsonAlignment * 0.25) + (balanceScore * 0.2);
+    return {
+        complete: directionsMissing.length === 0 && completenessScore >= 0.7,
+        directionsVisited,
+        directionsMissing,
+        ceremoniesPerDirection,
+        beatsPerDirection,
+        wilsonAlignment,
+        ocapCompliant,
+        completenessScore: Math.round(completenessScore * 100) / 100,
+    };
+}
+/** Compute balance across directions (1.0 = perfectly balanced) */
+function computeBalance(beatsPerDirection) {
+    const counts = Object.values(beatsPerDirection);
+    const total = counts.reduce((s, c) => s + c, 0);
+    if (total === 0)
+        return 0;
+    const ideal = total / 4;
+    const deviation = counts.reduce((sum, c) => sum + Math.abs(c - ideal), 0);
+    const maxDeviation = total; // worst case: all beats in one direction
+    return 1 - (deviation / maxDeviation);
+}
+/** Validate a complete narrative arc */
+function validateArc(beats, ceremonies, relations) {
+    const completeness = computeCompleteness(beats, ceremonies, relations);
+    const violations = [];
+    const recommendations = [];
+    // Missing directions
+    for (const dir of completeness.directionsMissing) {
+        violations.push({
+            type: 'missing_direction',
+            direction: dir,
+            message: `Direction '${dir}' has no beats`,
+            severity: 'error',
+        });
+        recommendations.push(`Add at least one beat in the ${dir} direction`);
+    }
+    // Directions without ceremonies
+    for (const dir of ALL_DIRECTIONS) {
+        if (completeness.ceremoniesPerDirection[dir] === 0 && completeness.beatsPerDirection[dir] > 0) {
+            violations.push({
+                type: 'no_ceremony',
+                direction: dir,
+                message: `Direction '${dir}' has beats but no ceremony`,
+                severity: 'warning',
+            });
+            recommendations.push(`Consider conducting a ceremony in the ${dir} direction`);
+        }
+    }
+    // Low Wilson alignment
+    if (completeness.wilsonAlignment < 0.5 && relations.length > 0) {
+        violations.push({
+            type: 'low_wilson',
+            message: `Wilson alignment is ${(completeness.wilsonAlignment * 100).toFixed(0)}% (below 50% threshold)`,
+            severity: 'warning',
+        });
+        recommendations.push('Strengthen relational accountability — review obligations and reciprocity');
+    }
+    // OCAP compliance gaps
+    if (!completeness.ocapCompliant) {
+        violations.push({
+            type: 'ocap_gap',
+            message: 'Not all relations are OCAP®-compliant',
+            severity: 'error',
+        });
+        recommendations.push('Review data sovereignty flags on all relations — ensure ownership, control, access, and possession');
+    }
+    // Balance check
+    const balance = computeBalance(completeness.beatsPerDirection);
+    if (balance < 0.5 && beats.length >= 4) {
+        const maxDir = ALL_DIRECTIONS.reduce((a, b) => completeness.beatsPerDirection[a] > completeness.beatsPerDirection[b] ? a : b);
+        const minDir = ALL_DIRECTIONS.reduce((a, b) => completeness.beatsPerDirection[a] < completeness.beatsPerDirection[b] ? a : b);
+        violations.push({
+            type: 'unbalanced',
+            message: `Beats are unbalanced: '${maxDir}' has ${completeness.beatsPerDirection[maxDir]}, '${minDir}' has ${completeness.beatsPerDirection[minDir]}`,
+            severity: 'info',
+        });
+        recommendations.push(`Balance the arc — add beats in '${minDir}' direction`);
+    }
+    const errorCount = violations.filter(v => v.severity === 'error').length;
+    return {
+        valid: errorCount === 0 && completeness.complete,
+        completeness,
+        violations,
+        recommendations,
+    };
+}
+/** Quick check: has a cycle visited all four directions? */
+function isArcComplete(beats) {
+    const visited = new Set(beats.map(b => b.direction));
+    return ALL_DIRECTIONS.every(d => visited.has(d));
+}
+//# sourceMappingURL=arc.js.map

package/dist/arc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arc.js","sourceRoot":"","sources":["../src/arc.ts"],"names":[],"mappings":";;AAqBA,kDA0CC;AAeD,kCA8EC;AAGD,sCAGC;AAvJD,iEAA8F;AAO9F,MAAM,cAAc,GAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3E,kDAAkD;AAClD,SAAgB,mBAAmB,CACjC,KAAsB,EACtB,UAAyB,EACzB,SAAqB;IAErB,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAoB,CAAC;IACvF,MAAM,iBAAiB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAErF,MAAM,iBAAiB,GAAkC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAClG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,sBAAsB,GAAkC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACvG,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,sBAAsB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,eAAe,GAAG,IAAA,wCAAwB,EAAC,SAAS,CAAC,CAAC;IAE5D,kBAAkB;IAClB,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAA,mCAAmB,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;IAE7F,uCAAuC;IACvC,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3F,MAAM,YAAY,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACvD,MAAM,iBAAiB,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC;IAE5H,OAAO;QACL,QAAQ,EAAE,iBAAiB,CAAC,MAAM,KAAK,CAAC,IAAI,iBAAiB,IAAI,GAAG;QACpE,iBAAiB;QACjB,iBAAiB;QACjB,sBAAsB;QACtB,iBAAiB;QACjB,eAAe;QACf,aAAa;QACb,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,GAAG,CAAC,GAAG,GAAG;KAC7D,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,SAAS,cAAc,CAAC,iBAAgD;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE1B,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,yCAAyC;IACrE,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,YAAY,CAAC,CAAC;AACxC,CAAC;AAED,wCAAwC;AACxC,SAAgB,WAAW,CACzB,KAAsB,EACtB,UAAyB,EACzB,SAAqB;IAErB,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACvE,MAAM,UAAU,GAAmB,EAAE,CAAC;IACtC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,qBAAqB;IACrB,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE,CAAC;QACjD,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,cAAc,GAAG,gBAAgB;YAC1C,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,eAAe,CAAC,IAAI,CAAC,gCAAgC,GAAG,YAAY,CAAC,CAAC;IACxE,CAAC;IAED,gCAAgC;IAChC,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,IAAI,YAAY,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9F,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,GAAG;gBACd,OAAO,EAAE,cAAc,GAAG,6BAA6B;gBACvD,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;YACH,eAAe,CAAC,IAAI,CAAC,yCAAyC,GAAG,YAAY,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,YAAY,CAAC,eAAe,GAAG,GAAG,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB;YACxG,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;QACH,eAAe,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IACpG,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC;QAChC,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,eAAe,CAAC,IAAI,CAAC,oGAAoG,CAAC,CAAC;IAC7H,CAAC;IAED,gBAAgB;IAChB,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAC/D,IAAI,OAAO,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC5C,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC9E,CAAC;QACF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC5C,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC9E,CAAC;QACF,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,0BAA0B,MAAM,SAAS,YAAY,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,MAAM,SAAS,YAAY,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE;YACrJ,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,eAAe,CAAC,IAAI,CAAC,mCAAmC,MAAM,aAAa,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAEzE,OAAO;QACL,KAAK,EAAE,UAAU,KAAK,CAAC,IAAI,YAAY,CAAC,QAAQ;QAChD,YAAY;QACZ,UAAU;QACV,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,SAAgB,aAAa,CAAC,KAAsB;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/cadence.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Cadence Patterns — ceremonial timing rules for narrative progression.
+ *
+ * A cadence maps the four directions to four phases:
+ *   East → opening, South → deepening, West → integrating, North → closing
+ */
+import type { NarrativeBeat, DirectionName, CeremonyLog } from '@medicine-wheel/ontology-core';
+import type { CadencePattern, CadencePhase, CadenceValidation } from './types.js';
+/** The standard four-direction cadence pattern */
+export declare const STANDARD_CADENCE: CadencePattern;
+/** A lighter cadence — ceremonies only at opening and closing */
+export declare const LIGHT_CADENCE: CadencePattern;
+/** Determine the current cadence phase from beats */
+export declare function currentPhase(beats: NarrativeBeat[]): CadencePhase;
+/** Map a direction to its cadence phase */
+export declare function directionToPhase(direction: DirectionName): CadencePhase;
+/** Map a cadence phase to its direction */
+export declare function phaseToDirection(phase: CadencePhase): DirectionName;
+/** Validate beats against a cadence pattern */
+export declare function validateCadence(beats: NarrativeBeat[], ceremonies: CeremonyLog[], pattern?: CadencePattern): CadenceValidation;
+/** Detect direction transitions in beat sequence */
+export declare function detectTransitions(beats: NarrativeBeat[]): Array<{
+    from: DirectionName;
+    to: DirectionName;
+    beatIndex: number;
+}>;
+//# sourceMappingURL=cadence.d.ts.map

package/dist/cadence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.d.ts","sourceRoot":"","sources":["../src/cadence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EAEZ,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAkBpB,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,EAAE,cAS9B,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,cAS3B,CAAC;AAEF,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,YAAY,CAIjE;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,YAAY,CAEvE;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAEnE;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,WAAW,EAAE,EACzB,OAAO,GAAE,cAAiC,GACzC,iBAAiB,CAoEnB;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAC/D,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAYD"}

package/dist/cadence.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIGHT_CADENCE = exports.STANDARD_CADENCE = void 0;
+exports.currentPhase = currentPhase;
+exports.directionToPhase = directionToPhase;
+exports.phaseToDirection = phaseToDirection;
+exports.validateCadence = validateCadence;
+exports.detectTransitions = detectTransitions;
+const PHASE_DIRECTION = {
+    opening: 'east',
+    deepening: 'south',
+    integrating: 'west',
+    closing: 'north',
+};
+const DIRECTION_PHASE = {
+    east: 'opening',
+    south: 'deepening',
+    west: 'integrating',
+    north: 'closing',
+};
+const PHASE_ORDER = ['opening', 'deepening', 'integrating', 'closing'];
+/** The standard four-direction cadence pattern */
+exports.STANDARD_CADENCE = {
+    name: 'Standard Four-Direction Cadence',
+    description: 'Balanced progression through all four directions with ceremony at each transition',
+    phases: [
+        { phase: 'opening', direction: 'east', requiresCeremony: true, minBeats: 1, maxBeats: 4 },
+        { phase: 'deepening', direction: 'south', requiresCeremony: true, minBeats: 1, maxBeats: 4 },
+        { phase: 'integrating', direction: 'west', requiresCeremony: true, minBeats: 1, maxBeats: 4 },
+        { phase: 'closing', direction: 'north', requiresCeremony: true, minBeats: 1, maxBeats: 4 },
+    ],
+};
+/** A lighter cadence — ceremonies only at opening and closing */
+exports.LIGHT_CADENCE = {
+    name: 'Light Cadence',
+    description: 'Ceremonies at opening (East) and closing (North) only',
+    phases: [
+        { phase: 'opening', direction: 'east', requiresCeremony: true, minBeats: 1, maxBeats: 6 },
+        { phase: 'deepening', direction: 'south', requiresCeremony: false, minBeats: 1, maxBeats: 6 },
+        { phase: 'integrating', direction: 'west', requiresCeremony: false, minBeats: 1, maxBeats: 6 },
+        { phase: 'closing', direction: 'north', requiresCeremony: true, minBeats: 1, maxBeats: 6 },
+    ],
+};
+/** Determine the current cadence phase from beats */
+function currentPhase(beats) {
+    if (beats.length === 0)
+        return 'opening';
+    const lastDirection = beats[beats.length - 1].direction;
+    return DIRECTION_PHASE[lastDirection];
+}
+/** Map a direction to its cadence phase */
+function directionToPhase(direction) {
+    return DIRECTION_PHASE[direction];
+}
+/** Map a cadence phase to its direction */
+function phaseToDirection(phase) {
+    return PHASE_DIRECTION[phase];
+}
+/** Validate beats against a cadence pattern */
+function validateCadence(beats, ceremonies, pattern = exports.STANDARD_CADENCE) {
+    const violations = [];
+    // Group beats by direction → phase
+    const beatsByPhase = new Map();
+    for (const phase of PHASE_ORDER) {
+        beatsByPhase.set(phase, []);
+    }
+    for (const beat of beats) {
+        const phase = DIRECTION_PHASE[beat.direction];
+        beatsByPhase.get(phase).push(beat);
+    }
+    // Ceremony IDs referenced by beats
+    const ceremonyIds = new Set(ceremonies.map(c => c.id));
+    const phasesCompleted = [];
+    const phasesRemaining = [];
+    for (const rule of pattern.phases) {
+        const phaseBeats = beatsByPhase.get(rule.phase) ?? [];
+        if (phaseBeats.length === 0) {
+            phasesRemaining.push(rule.phase);
+            continue;
+        }
+        // Check min/max beats
+        if (phaseBeats.length < rule.minBeats) {
+            violations.push({
+                phase: rule.phase,
+                rule: 'minBeats',
+                message: `Phase '${rule.phase}' has ${phaseBeats.length} beats (minimum: ${rule.minBeats})`,
+            });
+        }
+        if (phaseBeats.length > rule.maxBeats) {
+            violations.push({
+                phase: rule.phase,
+                rule: 'maxBeats',
+                message: `Phase '${rule.phase}' has ${phaseBeats.length} beats (maximum: ${rule.maxBeats})`,
+            });
+        }
+        // Check ceremony requirement
+        if (rule.requiresCeremony) {
+            const hasCeremony = phaseBeats.some(b => b.ceremonies.some((cId) => ceremonyIds.has(cId)));
+            if (!hasCeremony) {
+                violations.push({
+                    phase: rule.phase,
+                    rule: 'requiresCeremony',
+                    message: `Phase '${rule.phase}' requires a ceremony but none found`,
+                });
+            }
+        }
+        phasesCompleted.push(rule.phase);
+    }
+    const phase = currentPhase(beats);
+    const errorViolations = violations.filter(v => v.rule === 'requiresCeremony' || v.rule === 'minBeats');
+    return {
+        valid: errorViolations.length === 0 && phasesRemaining.length === 0,
+        currentPhase: phase,
+        phasesCompleted,
+        phasesRemaining,
+        violations,
+    };
+}
+/** Detect direction transitions in beat sequence */
+function detectTransitions(beats) {
+    const transitions = [];
+    for (let i = 1; i < beats.length; i++) {
+        if (beats[i].direction !== beats[i - 1].direction) {
+            transitions.push({
+                from: beats[i - 1].direction,
+                to: beats[i].direction,
+                beatIndex: i,
+            });
+        }
+    }
+    return transitions;
+}
+//# sourceMappingURL=cadence.js.map

package/dist/cadence.js.map

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

package/dist/cycle.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cycle Manager — orchestrates a full Medicine Wheel narrative cycle,
+ * tracking transitions, progress, and suggesting next steps.
+ */
+import type { NarrativeBeat, MedicineWheelCycle, CeremonyLog, Relation } from '@medicine-wheel/ontology-core';
+import type { CycleTransition, CycleProgress } from './types.js';
+/** Extract direction transitions from a beat sequence */
+export declare function extractTransitions(beats: NarrativeBeat[], ceremonies: CeremonyLog[]): CycleTransition[];
+/** Compute full cycle progress */
+export declare function computeProgress(cycle: MedicineWheelCycle, beats: NarrativeBeat[], ceremonies: CeremonyLog[], relations: Relation[]): CycleProgress;
+/** Create a new cycle with initial metadata */
+export declare function createCycle(id: string, researchQuestion: string): MedicineWheelCycle;
+/** Update cycle metadata from current beats/ceremonies/relations */
+export declare function updateCycleMetadata(cycle: MedicineWheelCycle, beats: NarrativeBeat[], ceremonies: CeremonyLog[], relations: Relation[]): MedicineWheelCycle;
+//# sourceMappingURL=cycle.d.ts.map

package/dist/cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle.d.ts","sourceRoot":"","sources":["../src/cycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAElB,WAAW,EACX,QAAQ,EACT,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKjE,yDAAyD;AACzD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,WAAW,EAAE,GACxB,eAAe,EAAE,CAkBnB;AAED,kCAAkC;AAClC,wBAAgB,eAAe,CAC7B,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,WAAW,EAAE,EACzB,SAAS,EAAE,QAAQ,EAAE,GACpB,aAAa,CAwCf;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,gBAAgB,EAAE,MAAM,GACvB,kBAAkB,CAYpB;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,WAAW,EAAE,EACzB,SAAS,EAAE,QAAQ,EAAE,GACpB,kBAAkB,CAapB"}

package/dist/cycle.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTransitions = extractTransitions;
+exports.computeProgress = computeProgress;
+exports.createCycle = createCycle;
+exports.updateCycleMetadata = updateCycleMetadata;
+const cadence_js_1 = require("./cadence.js");
+const arc_js_1 = require("./arc.js");
+const sequencer_js_1 = require("./sequencer.js");
+/** Extract direction transitions from a beat sequence */
+function extractTransitions(beats, ceremonies) {
+    const transitions = [];
+    const ceremonyIds = new Set(ceremonies.map(c => c.id));
+    for (let i = 1; i < beats.length; i++) {
+        if (beats[i].direction !== beats[i - 1].direction) {
+            const transitionBeat = beats[i];
+            transitions.push({
+                from: beats[i - 1].direction,
+                to: beats[i].direction,
+                timestamp: transitionBeat.timestamp,
+                ceremonyConducted: transitionBeat.ceremonies.some((cId) => ceremonyIds.has(cId)),
+                beat: transitionBeat,
+            });
+        }
+    }
+    return transitions;
+}
+/** Compute full cycle progress */
+function computeProgress(cycle, beats, ceremonies, relations) {
+    const transitions = extractTransitions(beats, ceremonies);
+    const phase = (0, cadence_js_1.currentPhase)(beats);
+    const completeness = (0, arc_js_1.computeCompleteness)(beats, ceremonies, relations);
+    const next = (0, sequencer_js_1.nextDirection)(beats);
+    let suggestedAction;
+    if (beats.length === 0) {
+        suggestedAction = 'Begin the cycle with a beat in the East (opening) direction';
+    }
+    else if (next) {
+        const phaseNames = {
+            east: 'opening',
+            south: 'deepening',
+            west: 'integrating',
+            north: 'closing',
+        };
+        suggestedAction = `Move to the ${next} direction (${phaseNames[next]} phase)`;
+        // Check if a ceremony is needed at the transition
+        const lastTransition = transitions[transitions.length - 1];
+        if (lastTransition && !lastTransition.ceremonyConducted) {
+            suggestedAction += ' — consider conducting a transition ceremony first';
+        }
+    }
+    else if (!completeness.ocapCompliant) {
+        suggestedAction = 'Review OCAP® compliance on relations before closing the cycle';
+    }
+    else if (completeness.wilsonAlignment < 0.7) {
+        suggestedAction = `Strengthen Wilson alignment (currently ${(completeness.wilsonAlignment * 100).toFixed(0)}%) before closing`;
+    }
+    else {
+        suggestedAction = 'All directions visited — the cycle is ready to close';
+    }
+    return {
+        cycle,
+        transitions,
+        currentPhase: phase,
+        completeness,
+        nextDirection: next,
+        suggestedAction,
+    };
+}
+/** Create a new cycle with initial metadata */
+function createCycle(id, researchQuestion) {
+    return {
+        id,
+        research_question: researchQuestion,
+        start_date: new Date().toISOString(),
+        current_direction: 'east',
+        beats: [],
+        ceremonies_conducted: 0,
+        relations_mapped: 0,
+        wilson_alignment: 0,
+        ocap_compliant: true,
+    };
+}
+/** Update cycle metadata from current beats/ceremonies/relations */
+function updateCycleMetadata(cycle, beats, ceremonies, relations) {
+    const completeness = (0, arc_js_1.computeCompleteness)(beats, ceremonies, relations);
+    const lastDirection = beats.length > 0 ? beats[beats.length - 1].direction : 'east';
+    return {
+        ...cycle,
+        current_direction: lastDirection,
+        beats: beats.map(b => b.id),
+        ceremonies_conducted: ceremonies.length,
+        relations_mapped: relations.length,
+        wilson_alignment: completeness.wilsonAlignment,
+        ocap_compliant: completeness.ocapCompliant,
+    };
+}
+//# sourceMappingURL=cycle.js.map

package/dist/cycle.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @medicine-wheel/narrative-engine
+ *
+ * Beat sequencing, arc validation, cadence patterns, and timeline
+ * building for the Medicine Wheel Developer Suite.
+ */
+export type { BeatPosition, BeatInsertResult, SequencerOptions, CadencePhase, CadencePattern, CadencePhaseRule, CadenceValidation, CadenceViolation, ArcCompleteness, ArcViolation, ArcValidationResult, TimelineAxis, TimelineEntry, TimelineData, TimelineGroup, TimelineOptions, CycleTransition, CycleProgress, EpistemicDepth, NarrativeTransformation, } from './types.js';
+export { sequenceBeats, insertBeat, beatsByDirection, nextDirection, currentAct, suggestNextBeat, spiralOrder, detectEpistemicDeepening, findTransformationPoints, } from './sequencer.js';
+export { STANDARD_CADENCE, LIGHT_CADENCE, currentPhase, directionToPhase, phaseToDirection, validateCadence, detectTransitions, } from './cadence.js';
+export { computeCompleteness, validateArc, isArcComplete, } from './arc.js';
+export { buildTimeline, actStrip, } from './timeline.js';
+export { extractTransitions, computeProgress, createCycle, updateCycleMetadata, } from './cycle.js';
+export { generateProvenanceNarrative, generateReciprocityObservation, generateDirectionObservation, getCeremonyPhaseFraming, describeSun, } from './rsis-narrative.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;;;;;GAKG;AAGH,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,eAAe,EACf,WAAW,EACX,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,aAAa,EACb,QAAQ,GACT,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,EACvB,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * @medicine-wheel/narrative-engine
+ *
+ * Beat sequencing, arc validation, cadence patterns, and timeline
+ * building for the Medicine Wheel Developer Suite.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeSun = exports.getCeremonyPhaseFraming = exports.generateDirectionObservation = exports.generateReciprocityObservation = exports.generateProvenanceNarrative = exports.updateCycleMetadata = exports.createCycle = exports.computeProgress = exports.extractTransitions = exports.actStrip = exports.buildTimeline = exports.isArcComplete = exports.validateArc = exports.computeCompleteness = exports.detectTransitions = exports.validateCadence = exports.phaseToDirection = exports.directionToPhase = exports.currentPhase = exports.LIGHT_CADENCE = exports.STANDARD_CADENCE = exports.findTransformationPoints = exports.detectEpistemicDeepening = exports.spiralOrder = exports.suggestNextBeat = exports.currentAct = exports.nextDirection = exports.beatsByDirection = exports.insertBeat = exports.sequenceBeats = void 0;
+// Sequencer
+var sequencer_js_1 = require("./sequencer.js");
+Object.defineProperty(exports, "sequenceBeats", { enumerable: true, get: function () { return sequencer_js_1.sequenceBeats; } });
+Object.defineProperty(exports, "insertBeat", { enumerable: true, get: function () { return sequencer_js_1.insertBeat; } });
+Object.defineProperty(exports, "beatsByDirection", { enumerable: true, get: function () { return sequencer_js_1.beatsByDirection; } });
+Object.defineProperty(exports, "nextDirection", { enumerable: true, get: function () { return sequencer_js_1.nextDirection; } });
+Object.defineProperty(exports, "currentAct", { enumerable: true, get: function () { return sequencer_js_1.currentAct; } });
+Object.defineProperty(exports, "suggestNextBeat", { enumerable: true, get: function () { return sequencer_js_1.suggestNextBeat; } });
+Object.defineProperty(exports, "spiralOrder", { enumerable: true, get: function () { return sequencer_js_1.spiralOrder; } });
+Object.defineProperty(exports, "detectEpistemicDeepening", { enumerable: true, get: function () { return sequencer_js_1.detectEpistemicDeepening; } });
+Object.defineProperty(exports, "findTransformationPoints", { enumerable: true, get: function () { return sequencer_js_1.findTransformationPoints; } });
+// Cadence
+var cadence_js_1 = require("./cadence.js");
+Object.defineProperty(exports, "STANDARD_CADENCE", { enumerable: true, get: function () { return cadence_js_1.STANDARD_CADENCE; } });
+Object.defineProperty(exports, "LIGHT_CADENCE", { enumerable: true, get: function () { return cadence_js_1.LIGHT_CADENCE; } });
+Object.defineProperty(exports, "currentPhase", { enumerable: true, get: function () { return cadence_js_1.currentPhase; } });
+Object.defineProperty(exports, "directionToPhase", { enumerable: true, get: function () { return cadence_js_1.directionToPhase; } });
+Object.defineProperty(exports, "phaseToDirection", { enumerable: true, get: function () { return cadence_js_1.phaseToDirection; } });
+Object.defineProperty(exports, "validateCadence", { enumerable: true, get: function () { return cadence_js_1.validateCadence; } });
+Object.defineProperty(exports, "detectTransitions", { enumerable: true, get: function () { return cadence_js_1.detectTransitions; } });
+// Arc validation
+var arc_js_1 = require("./arc.js");
+Object.defineProperty(exports, "computeCompleteness", { enumerable: true, get: function () { return arc_js_1.computeCompleteness; } });
+Object.defineProperty(exports, "validateArc", { enumerable: true, get: function () { return arc_js_1.validateArc; } });
+Object.defineProperty(exports, "isArcComplete", { enumerable: true, get: function () { return arc_js_1.isArcComplete; } });
+// Timeline
+var timeline_js_1 = require("./timeline.js");
+Object.defineProperty(exports, "buildTimeline", { enumerable: true, get: function () { return timeline_js_1.buildTimeline; } });
+Object.defineProperty(exports, "actStrip", { enumerable: true, get: function () { return timeline_js_1.actStrip; } });
+// Cycle manager
+var cycle_js_1 = require("./cycle.js");
+Object.defineProperty(exports, "extractTransitions", { enumerable: true, get: function () { return cycle_js_1.extractTransitions; } });
+Object.defineProperty(exports, "computeProgress", { enumerable: true, get: function () { return cycle_js_1.computeProgress; } });
+Object.defineProperty(exports, "createCycle", { enumerable: true, get: function () { return cycle_js_1.createCycle; } });
+Object.defineProperty(exports, "updateCycleMetadata", { enumerable: true, get: function () { return cycle_js_1.updateCycleMetadata; } });
+// RSIS narrative generators
+var rsis_narrative_js_1 = require("./rsis-narrative.js");
+Object.defineProperty(exports, "generateProvenanceNarrative", { enumerable: true, get: function () { return rsis_narrative_js_1.generateProvenanceNarrative; } });
+Object.defineProperty(exports, "generateReciprocityObservation", { enumerable: true, get: function () { return rsis_narrative_js_1.generateReciprocityObservation; } });
+Object.defineProperty(exports, "generateDirectionObservation", { enumerable: true, get: function () { return rsis_narrative_js_1.generateDirectionObservation; } });
+Object.defineProperty(exports, "getCeremonyPhaseFraming", { enumerable: true, get: function () { return rsis_narrative_js_1.getCeremonyPhaseFraming; } });
+Object.defineProperty(exports, "describeSun", { enumerable: true, get: function () { return rsis_narrative_js_1.describeSun; } });
+//# 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;;;;;GAKG;;;AA0BH,YAAY;AACZ,+CAUwB;AATtB,6GAAA,aAAa,OAAA;AACb,0GAAA,UAAU,OAAA;AACV,gHAAA,gBAAgB,OAAA;AAChB,6GAAA,aAAa,OAAA;AACb,0GAAA,UAAU,OAAA;AACV,+GAAA,eAAe,OAAA;AACf,2GAAA,WAAW,OAAA;AACX,wHAAA,wBAAwB,OAAA;AACxB,wHAAA,wBAAwB,OAAA;AAG1B,UAAU;AACV,2CAQsB;AAPpB,8GAAA,gBAAgB,OAAA;AAChB,2GAAA,aAAa,OAAA;AACb,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,8GAAA,gBAAgB,OAAA;AAChB,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AAGnB,iBAAiB;AACjB,mCAIkB;AAHhB,6GAAA,mBAAmB,OAAA;AACnB,qGAAA,WAAW,OAAA;AACX,uGAAA,aAAa,OAAA;AAGf,WAAW;AACX,6CAGuB;AAFrB,4GAAA,aAAa,OAAA;AACb,uGAAA,QAAQ,OAAA;AAGV,gBAAgB;AAChB,uCAKoB;AAJlB,8GAAA,kBAAkB,OAAA;AAClB,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,+GAAA,mBAAmB,OAAA;AAGrB,4BAA4B;AAC5B,yDAM6B;AAL3B,gIAAA,2BAA2B,OAAA;AAC3B,mIAAA,8BAA8B,OAAA;AAC9B,iIAAA,4BAA4B,OAAA;AAC5B,4HAAA,uBAAuB,OAAA;AACvB,gHAAA,WAAW,OAAA"}

package/dist/rsis-narrative.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @medicine-wheel/narrative-engine — RSIS Narrative Generators
+ *
+ * Produces ceremony-phase-aware provenance stories, reciprocity
+ * narratives, and directional observations for RSIS tool outputs.
+ */
+import type { CeremonyPhase, CeremonyLineageEntry, DirectionDistribution, SunName } from '@medicine-wheel/ontology-core';
+/**
+ * Generate a human-readable provenance narrative for a code artifact
+ */
+export declare function generateProvenanceNarrative(symbolName: string, lineage: CeremonyLineageEntry[], inquiries: Array<{
+    name: string;
+}>, stewards: Array<{
+    name: string;
+}>): string;
+/**
+ * Generate a reciprocity observation — always invitational, never evaluative
+ */
+export declare function generateReciprocityObservation(stewardCount: number, flowCount: number): string;
+/**
+ * Generate a natural language observation about directional balance
+ */
+export declare function generateDirectionObservation(distribution: DirectionDistribution, total: number): string;
+/**
+ * Get ceremony-phase-aware framing for tool output
+ */
+export declare function getCeremonyPhaseFraming(phase?: CeremonyPhase): string;
+/**
+ * Describe a Thematic Sun
+ */
+export declare function describeSun(sun: SunName): string;
+//# sourceMappingURL=rsis-narrative.d.ts.map