@medicine-wheel/app 0.4.5 → 0.4.6

package/app/narrative/cycles/page.tsx

@@ -3,6 +3,7 @@
 import { useEffect, useState } from "react";
 import type { FormEvent } from "react";
 import { type MedicineWheelCycle, DIRECTION_COLORS, type DirectionName } from "@/lib/types";
+import { extractCycles } from "@/lib/cycle-response";
 import { toast } from "sonner";
 
 export default function CyclesPage() {
@@ -11,7 +12,10 @@ export default function CyclesPage() {
   const [expandedId, setExpandedId] = useState<string | null>(null);
 
   useEffect(() => {
-    fetch("/api/narrative/cycles").then((r) => r.json()).then((d) => setCycles(Array.isArray(d) ? d : [])).catch(() => setCycles([]));
+    fetch("/api/narrative/cycles")
+      .then((r) => r.json())
+      .then((d) => setCycles(extractCycles(d)))
+      .catch(() => setCycles([]));
   }, []);
 
   async function createCycle(e: FormEvent<HTMLFormElement>) {
@@ -23,7 +27,7 @@ export default function CyclesPage() {
       toast.success("Cycle created");
       setShowForm(false);
       const data = await fetch("/api/narrative/cycles").then((r) => r.json());
-      setCycles(Array.isArray(data) ? data : []);
+      setCycles(extractCycles(data));
     } else { toast.error("Failed"); }
   }
 

package/app/narrative/page.tsx

@@ -2,6 +2,7 @@
 
 import { useEffect, useState } from "react";
 import { type NarrativeBeat, type MedicineWheelCycle, DIRECTION_COLORS, type DirectionName } from "@/lib/types";
+import { extractCycles } from "@/lib/cycle-response";
 
 export default function NarrativePage() {
   const [beats, setBeats] = useState<NarrativeBeat[]>([]);
@@ -10,7 +11,7 @@ export default function NarrativePage() {
 
   useEffect(() => {
     Promise.all([fetch("/api/narrative/beats").then((r) => r.json()), fetch("/api/narrative/cycles").then((r) => r.json())])
-      .then(([b, c]) => { setBeats(Array.isArray(b) ? b : []); setCycles(Array.isArray(c) ? c : []); })
+      .then(([b, c]) => { setBeats(Array.isArray(b) ? b : []); setCycles(extractCycles(c)); })
       .catch(() => {});
   }, []);
 

package/lib/cycle-response.ts

@@ -0,0 +1,66 @@
+import type { DirectionName, MedicineWheelCycle } from "./types";
+
+interface CycleListResponse {
+  cycles?: unknown;
+}
+
+export type ApiMedicineWheelCycle = MedicineWheelCycle & {
+  archived?: boolean;
+};
+
+const DIRECTION_NAMES = new Set<DirectionName>(["east", "south", "west", "north"]);
+
+function asNonNegativeInteger(value: unknown): number {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0
+    ? Math.trunc(value)
+    : 0;
+}
+
+function asUnitInterval(value: unknown): number {
+  return typeof value === "number" && Number.isFinite(value)
+    ? Math.max(0, Math.min(1, value))
+    : 0;
+}
+
+export function normalizeMedicineWheelCycle(value: unknown): ApiMedicineWheelCycle | null {
+  if (!value || typeof value !== "object") return null;
+
+  const cycle = value as Record<string, unknown>;
+  if (typeof cycle.id !== "string" || typeof cycle.research_question !== "string") {
+    return null;
+  }
+
+  return {
+    id: cycle.id,
+    research_question: cycle.research_question,
+    start_date:
+      typeof cycle.start_date === "string"
+        ? cycle.start_date
+        : new Date(0).toISOString(),
+    current_direction:
+      typeof cycle.current_direction === "string" &&
+      DIRECTION_NAMES.has(cycle.current_direction as DirectionName)
+        ? (cycle.current_direction as DirectionName)
+        : "east",
+    beats: Array.isArray(cycle.beats)
+      ? cycle.beats.filter((beatId): beatId is string => typeof beatId === "string")
+      : [],
+    ceremonies_conducted: asNonNegativeInteger(cycle.ceremonies_conducted),
+    relations_mapped: asNonNegativeInteger(cycle.relations_mapped),
+    wilson_alignment: asUnitInterval(cycle.wilson_alignment),
+    ocap_compliant: cycle.ocap_compliant === true,
+    ...(cycle.archived === true ? { archived: true } : {}),
+  };
+}
+
+export function extractCycles(response: unknown): ApiMedicineWheelCycle[] {
+  const candidate = Array.isArray(response)
+    ? response
+    : response && typeof response === "object" && Array.isArray((response as CycleListResponse).cycles)
+      ? ((response as CycleListResponse).cycles as unknown[])
+      : [];
+
+  return candidate
+    .map(normalizeMedicineWheelCycle)
+    .filter((cycle): cycle is ApiMedicineWheelCycle => cycle !== null);
+}

package/lib/store.ts

@@ -22,6 +22,7 @@ import type {
   MedicineWheelCycle,
 } from '@/lib/types';
 
+import { extractCycles, normalizeMedicineWheelCycle } from './cycle-response';
 import { getJsonlStore } from './jsonl-store';
 
 // JSONL store for sync operations (used by seeding and legacy code paths)
@@ -151,7 +152,7 @@ export function createBeat(data: Omit<NarrativeBeat, 'id' | 'timestamp'> & { id?
 
 export function getAllCycles(): MedicineWheelCycle[] {
   const { active, archived } = store.getAllCycles();
-  return [...active, ...archived] as unknown as MedicineWheelCycle[];
+  return extractCycles([...active, ...archived]);
 }
 
 export function createCycle(data: { research_question: string; current_direction?: string }): MedicineWheelCycle {
@@ -168,7 +169,7 @@ export function createCycle(data: { research_question: string; current_direction
     ocap_compliant: false,
   };
   store.createCycle(cycle as any);
-  return cycle;
+  return normalizeMedicineWheelCycle(cycle) ?? cycle;
 }
 
 // ── Seed Data ──

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medicine-wheel/app",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Medicine Wheel — Interactive visual layer for Indigenous relational research with Four Directions, ceremonies, and narrative arcs",
   "bin": {
     "mw": "dist/cli/mw.js",
@@ -74,24 +74,24 @@
     "release:major": "npm run version:major && npm run publish:all && npm run release:commit"
   },
   "dependencies": {
-    "@medicine-wheel/ceremony-protocol": "^0.4.5",
-    "@medicine-wheel/community-review": "^0.4.5",
-    "@medicine-wheel/consent-lifecycle": "^0.4.5",
-    "@medicine-wheel/data-store": "^0.4.5",
-    "@medicine-wheel/data-store-postgres": "^0.4.5",
-    "@medicine-wheel/fire-keeper": "^0.4.5",
-    "@medicine-wheel/graph-viz": "^0.4.5",
-    "@medicine-wheel/importance-unit": "^0.4.5",
+    "@medicine-wheel/ceremony-protocol": "^0.4.6",
+    "@medicine-wheel/community-review": "^0.4.6",
+    "@medicine-wheel/consent-lifecycle": "^0.4.6",
+    "@medicine-wheel/data-store": "^0.4.6",
+    "@medicine-wheel/data-store-postgres": "^0.4.6",
+    "@medicine-wheel/fire-keeper": "^0.4.6",
+    "@medicine-wheel/graph-viz": "^0.4.6",
+    "@medicine-wheel/importance-unit": "^0.4.6",
     "@medicine-wheel/mcp": "^4.4.5",
-    "@medicine-wheel/narrative-engine": "^0.4.5",
-    "@medicine-wheel/ontology-core": "^0.4.5",
-    "@medicine-wheel/prompt-decomposition": "^0.4.5",
-    "@medicine-wheel/relational-index": "^0.4.5",
-    "@medicine-wheel/relational-query": "^0.4.5",
-    "@medicine-wheel/session-reader": "^0.4.5",
-    "@medicine-wheel/storage-provider": "^0.4.5",
-    "@medicine-wheel/transformation-tracker": "^0.4.5",
-    "@medicine-wheel/ui-components": "^0.4.5",
+    "@medicine-wheel/narrative-engine": "^0.4.6",
+    "@medicine-wheel/ontology-core": "^0.4.6",
+    "@medicine-wheel/prompt-decomposition": "^0.4.6",
+    "@medicine-wheel/relational-index": "^0.4.6",
+    "@medicine-wheel/relational-query": "^0.4.6",
+    "@medicine-wheel/session-reader": "^0.4.6",
+    "@medicine-wheel/storage-provider": "^0.4.6",
+    "@medicine-wheel/transformation-tracker": "^0.4.6",
+    "@medicine-wheel/ui-components": "^0.4.6",
     "@neondatabase/serverless": "^0.10.0",
     "clsx": "^2.1.1",
     "lucide-react": "^0.475.0",