@medicine-wheel/narrative-engine 0.2.2

package/dist/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * @medicine-wheel/narrative-engine — types
+ *
+ * Extends ontology-core types with engine-specific interfaces
+ * for beat sequencing, cadence patterns, and arc validation.
+ */
+import type { DirectionName, NarrativeBeat, MedicineWheelCycle } from '@medicine-wheel/ontology-core';
+export interface BeatPosition {
+    beat: NarrativeBeat;
+    index: number;
+    direction: DirectionName;
+    act: number;
+}
+export interface BeatInsertResult {
+    success: boolean;
+    positions: BeatPosition[];
+    warnings: string[];
+}
+export interface SequencerOptions {
+    /** Enforce direction order: east → south → west → north */
+    enforceDirectionOrder?: boolean;
+    /** Allow multiple beats per act */
+    allowMultiplePerAct?: boolean;
+    /** Maximum beats per direction */
+    maxBeatsPerDirection?: number;
+}
+export type CadencePhase = 'opening' | 'deepening' | 'integrating' | 'closing';
+export interface CadencePattern {
+    name: string;
+    description: string;
+    phases: CadencePhaseRule[];
+}
+export interface CadencePhaseRule {
+    phase: CadencePhase;
+    direction: DirectionName;
+    requiresCeremony: boolean;
+    minBeats: number;
+    maxBeats: number;
+}
+export interface CadenceValidation {
+    valid: boolean;
+    currentPhase: CadencePhase;
+    phasesCompleted: CadencePhase[];
+    phasesRemaining: CadencePhase[];
+    violations: CadenceViolation[];
+}
+export interface CadenceViolation {
+    phase: CadencePhase;
+    rule: string;
+    message: string;
+}
+export interface ArcCompleteness {
+    complete: boolean;
+    directionsVisited: DirectionName[];
+    directionsMissing: DirectionName[];
+    ceremoniesPerDirection: Record<DirectionName, number>;
+    beatsPerDirection: Record<DirectionName, number>;
+    wilsonAlignment: number;
+    ocapCompliant: boolean;
+    completenessScore: number;
+}
+export interface ArcViolation {
+    type: 'missing_direction' | 'no_ceremony' | 'low_wilson' | 'ocap_gap' | 'unbalanced';
+    direction?: DirectionName;
+    message: string;
+    severity: 'error' | 'warning' | 'info';
+}
+export interface ArcValidationResult {
+    valid: boolean;
+    completeness: ArcCompleteness;
+    violations: ArcViolation[];
+    recommendations: string[];
+}
+export type TimelineAxis = 'chronological' | 'directional' | 'ceremonial';
+export interface TimelineEntry {
+    beat: NarrativeBeat;
+    position: number;
+    direction: DirectionName;
+    act: number;
+    hasCeremony: boolean;
+    group: string;
+}
+export interface TimelineData {
+    axis: TimelineAxis;
+    entries: TimelineEntry[];
+    groups: TimelineGroup[];
+    span: {
+        start: string;
+        end: string;
+    };
+}
+export interface TimelineGroup {
+    key: string;
+    label: string;
+    color: string;
+    entries: TimelineEntry[];
+}
+export interface TimelineOptions {
+    axis?: TimelineAxis;
+    filterDirection?: DirectionName;
+    filterAct?: number;
+    sortBy?: 'timestamp' | 'act' | 'direction';
+}
+export interface CycleTransition {
+    from: DirectionName;
+    to: DirectionName;
+    timestamp: string;
+    ceremonyConducted: boolean;
+    beat?: NarrativeBeat;
+}
+export interface CycleProgress {
+    cycle: MedicineWheelCycle;
+    transitions: CycleTransition[];
+    currentPhase: CadencePhase;
+    completeness: ArcCompleteness;
+    nextDirection: DirectionName | null;
+    suggestedAction: string;
+}
+/** Measures whether narrative beats show genuine deepening of understanding */
+export interface EpistemicDepth {
+    /** How many full circles through the four directions have been completed */
+    circleCount: number;
+    /** Indicators that understanding is genuinely deepening */
+    deepeningIndicators: string[];
+    /** Whether the narrative risks stagnation (circling without progress) */
+    stagnationRisk: boolean;
+}
+/** A point in the narrative where understanding visibly shifted */
+export interface NarrativeTransformation {
+    /** The beat where transformation occurred */
+    beatId: string;
+    /** Understanding before this beat */
+    beforeUnderstanding: string;
+    /** Understanding after this beat */
+    afterUnderstanding: string;
+    /** What catalysed the shift */
+    catalyst: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@medicine-wheel/narrative-engine",
+  "version": "0.2.2",
+  "description": "Beat sequencing, arc validation, and ceremonial cadence engine for the Medicine Wheel Developer Suite",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "narrative",
+    "indigenous",
+    "four-directions",
+    "beat-sequencing",
+    "ceremony"
+  ],
+  "author": "jgwill",
+  "license": "MIT",
+  "dependencies": {
+    "@medicine-wheel/ontology-core": "^0.2.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}