@medicine-wheel/app 0.2.3

package/lib/store.ts

@@ -0,0 +1,226 @@
+/**
+ * Medicine Wheel — Web UI Data Store
+ *
+ * Provider-agnostic data layer that supports multiple backends:
+ * - JSONL (default for local development)
+ * - Neon/Postgres (production on Vercel)
+ * - Redis/Upstash (coming soon)
+ *
+ * Backend selection via MW_STORAGE_PROVIDER env var:
+ * - 'neon' or 'postgres' → NeonProvider (requires DATABASE_URL)
+ * - 'jsonl' or unset → JsonlProvider (file-based)
+ *
+ * @see lib/jsonl-store.ts — the JSONL persistence engine (fallback)
+ * @see src/storage-provider — the provider abstraction layer
+ */
+
+import type {
+  RelationalNode,
+  RelationalEdge,
+  CeremonyLog,
+  NarrativeBeat,
+  MedicineWheelCycle,
+} from '@/lib/types';
+
+import { getJsonlStore } from './jsonl-store';
+
+// JSONL store for sync operations (used by seeding and legacy code paths)
+// For async provider access (Neon), use API routes or import from @medicine-wheel/storage-provider directly
+const store = getJsonlStore();
+
+// ── Nodes ──
+
+export function getAllNodes(): RelationalNode[] {
+  return store.getAllNodes() as unknown as RelationalNode[];
+}
+
+export function getNodesByType(type: string): RelationalNode[] {
+  return store.getNodesByType(type) as unknown as RelationalNode[];
+}
+
+export function getNodesByDirection(direction: string): RelationalNode[] {
+  return store.getNodesByDirection(direction) as unknown as RelationalNode[];
+}
+
+export function getNode(id: string): RelationalNode | null {
+  return (store.getNode(id) as unknown as RelationalNode) ?? null;
+}
+
+export function createNode(data: Omit<RelationalNode, 'id' | 'created_at' | 'updated_at' | 'metadata'> & { id?: string; metadata?: Record<string, unknown> }): RelationalNode {
+  const id = data.id || crypto.randomUUID();
+  const now = new Date().toISOString();
+  const node: RelationalNode = {
+    id,
+    name: data.name,
+    type: data.type,
+    direction: data.direction,
+    metadata: data.metadata ?? {},
+    created_at: now,
+    updated_at: now,
+  };
+  store.createNode(node as any);
+  return node;
+}
+
+// ── Edges ──
+
+export function getAllEdges(): RelationalEdge[] {
+  return store.edges.getAll() as unknown as RelationalEdge[];
+}
+
+export function getEdgesByNode(nodeId: string): RelationalEdge[] {
+  return store.getEdgesForNode(nodeId) as unknown as RelationalEdge[];
+}
+
+export function createEdge(data: Omit<RelationalEdge, 'id' | 'created_at'> & { id?: string }): RelationalEdge {
+  const id = data.id || `${data.from_id}:${data.to_id}`;
+  const now = new Date().toISOString();
+  const edge: RelationalEdge = {
+    id,
+    from_id: data.from_id,
+    to_id: data.to_id,
+    relationship_type: data.relationship_type,
+    strength: data.strength ?? 0.5,
+    ceremony_honored: data.ceremony_honored ?? false,
+    obligations: data.obligations ?? [],
+    created_at: now,
+  };
+  store.createEdge(edge as any);
+  return edge;
+}
+
+// ── Ceremonies ──
+
+export function getAllCeremonies(): CeremonyLog[] {
+  return store.getAllCeremonies() as unknown as CeremonyLog[];
+}
+
+export function getCeremoniesByDirection(direction: string): CeremonyLog[] {
+  return store.getCeremoniesByDirection(direction) as unknown as CeremonyLog[];
+}
+
+export function getCeremoniesByType(type: string): CeremonyLog[] {
+  return store.getCeremoniesByType(type) as unknown as CeremonyLog[];
+}
+
+export function createCeremony(data: Omit<CeremonyLog, 'id' | 'timestamp'> & { id?: string; timestamp?: string }): CeremonyLog {
+  const id = data.id || crypto.randomUUID();
+  const ceremony: CeremonyLog = {
+    id,
+    type: data.type,
+    direction: data.direction,
+    participants: data.participants ?? [],
+    medicines_used: data.medicines_used ?? [],
+    intentions: data.intentions ?? [],
+    timestamp: data.timestamp || new Date().toISOString(),
+    research_context: data.research_context,
+  };
+  store.logCeremony(ceremony as any);
+  return ceremony;
+}
+
+// ── Narrative Beats ──
+
+export function getAllBeats(): NarrativeBeat[] {
+  return store.getAllBeats() as unknown as NarrativeBeat[];
+}
+
+export function getBeatsByDirection(direction: string): NarrativeBeat[] {
+  return store.getBeatsByDirection(direction) as unknown as NarrativeBeat[];
+}
+
+export function createBeat(data: Omit<NarrativeBeat, 'id' | 'timestamp'> & { id?: string; timestamp?: string }): NarrativeBeat {
+  const id = data.id || crypto.randomUUID();
+  const beat: NarrativeBeat = {
+    id,
+    direction: data.direction,
+    title: data.title,
+    description: data.description,
+    prose: data.prose,
+    ceremonies: data.ceremonies ?? [],
+    learnings: data.learnings ?? [],
+    timestamp: data.timestamp || new Date().toISOString(),
+    act: data.act ?? 1,
+    relations_honored: data.relations_honored ?? [],
+  };
+  store.createBeat(beat as any);
+  return beat;
+}
+
+// ── Cycles ──
+
+export function getAllCycles(): MedicineWheelCycle[] {
+  const { active, archived } = store.getAllCycles();
+  return [...active, ...archived] as unknown as MedicineWheelCycle[];
+}
+
+export function createCycle(data: { research_question: string; current_direction?: string }): MedicineWheelCycle {
+  const id = `cycle-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  const cycle: MedicineWheelCycle = {
+    id,
+    research_question: data.research_question,
+    start_date: new Date().toISOString(),
+    current_direction: (data.current_direction as any) || 'east',
+    beats: [],
+    ceremonies_conducted: 0,
+    relations_mapped: 0,
+    wilson_alignment: 0,
+    ocap_compliant: false,
+  };
+  store.createCycle(cycle as any);
+  return cycle;
+}
+
+// ── Seed Data ──
+
+export function seedDemoData() {
+  if (store.nodes.size() > 0) return; // Already seeded
+
+  // Create some demo nodes
+  createNode({ name: 'Elder Sarah', type: 'human', direction: 'north' });
+  createNode({ name: 'Youth Circle', type: 'human', direction: 'south' });
+  createNode({ name: 'Turtle Island', type: 'land', direction: 'east' });
+  createNode({ name: 'Sacred River', type: 'land', direction: 'west' });
+  createNode({ name: 'Ancestor Teachings', type: 'ancestor', direction: 'north' });
+  createNode({ name: 'Dream Vision', type: 'spirit', direction: 'east' });
+  createNode({ name: 'Seven Generations', type: 'future', direction: 'south' });
+  createNode({ name: 'Oral Traditions', type: 'knowledge', direction: 'west' });
+
+  const allN = getAllNodes();
+  // Create edges between nodes
+  if (allN.length >= 4) {
+    createEdge({ from_id: allN[0].id, to_id: allN[1].id, relationship_type: 'mentorship', strength: 0.9, ceremony_honored: true, obligations: ['teaching', 'guidance'] });
+    createEdge({ from_id: allN[0].id, to_id: allN[4].id, relationship_type: 'carries_teachings', strength: 0.8, ceremony_honored: true, obligations: ['remembering'] });
+    createEdge({ from_id: allN[2].id, to_id: allN[3].id, relationship_type: 'stewardship', strength: 0.7, ceremony_honored: false, obligations: ['land care'] });
+    createEdge({ from_id: allN[1].id, to_id: allN[6].id, relationship_type: 'responsibility', strength: 0.6, ceremony_honored: false, obligations: ['future planning'] });
+    createEdge({ from_id: allN[5].id, to_id: allN[7].id, relationship_type: 'inspiration', strength: 0.8, ceremony_honored: true, obligations: ['listening'] });
+  }
+
+  // Create a demo ceremony
+  createCeremony({
+    type: 'smudging',
+    direction: 'east',
+    participants: ['Elder Sarah', 'Youth Circle'],
+    medicines_used: ['sage', 'tobacco'],
+    intentions: ['Opening the research journey with gratitude'],
+    research_context: 'Beginning relational inquiry',
+  });
+
+  // Create a demo beat
+  createBeat({
+    direction: 'east',
+    title: 'Vision Quest Beginning',
+    description: 'Initial visioning for the research journey',
+    prose: 'We begin in the East, where the sun rises...',
+    ceremonies: [],
+    learnings: ['Relational accountability starts with listening'],
+    act: 1,
+    relations_honored: [],
+  });
+
+  // Create a demo cycle
+  createCycle({ research_question: 'How do we honor relational accountability in software development?' });
+}
+
+// Auto-seed on import
+seedDemoData();

package/lib/types.ts

@@ -0,0 +1,23 @@
+/**
+ * Medicine Wheel — Type Definitions
+ * Re-exported from @medicine-wheel/ontology-core.
+ */
+
+export type {
+  DirectionName,
+  NodeType,
+  CeremonyType,
+  RelationalNode,
+  RelationalEdge,
+  CeremonyLog,
+  NarrativeBeat,
+  MedicineWheelCycle,
+  Direction,
+} from '@medicine-wheel/ontology-core';
+
+export {
+  DIRECTIONS,
+  DIRECTION_COLORS,
+  NODE_TYPE_COLORS,
+  CEREMONY_ICONS,
+} from '@medicine-wheel/ontology-core';

package/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+/// <reference path="./.next/types/routes.d.ts" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/next.config.mjs

@@ -0,0 +1,5 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  images: { unoptimized: true },
+};
+export default nextConfig;

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "@medicine-wheel/app",
+  "version": "0.2.3",
+  "description": "Medicine Wheel — Interactive visual layer for Indigenous relational research with Four Directions, ceremonies, and narrative arcs",
+  "bin": {
+    "mw": "dist/cli/mw.js",
+    "mwsrv": "dist/cli/mwsrv.js"
+  },
+  "files": [
+    "app/**/*",
+    "components/**/*",
+    "hooks/**/*",
+    "lib/**/*",
+    "public/**/*",
+    "dist/cli/**/*",
+    "next.config.mjs",
+    "next-env.d.ts",
+    "postcss.config.mjs",
+    "tsconfig.json",
+    "Dockerfile",
+    "docker-entrypoint.sh",
+    "docker-build-push.sh",
+    "README.md"
+  ],
+  "workspaces": [
+    "src/ceremony-protocol",
+    "src/community-review",
+    "src/consent-lifecycle",
+    "src/data-store",
+    "src/data-store-postgres",
+    "src/fire-keeper",
+    "src/graph-viz",
+    "src/importance-unit",
+    "src/narrative-engine",
+    "src/ontology-core",
+    "src/prompt-decomposition",
+    "src/relational-index",
+    "src/relational-query",
+    "src/session-reader",
+    "src/storage-provider",
+    "src/transformation-tracker",
+    "src/ui-components",
+    "mcp"
+  ],
+  "scripts": {
+    "build:packages": "npm run build -w src/ontology-core && npm run build --workspaces --if-present",
+    "build:cli": "tsc -p tsconfig.cli.json && chmod +x dist/cli/mw.js dist/cli/mwsrv.js",
+    "clean:packages": "npm run clean --workspaces --if-present",
+    "prebuild": "npm run build:packages",
+    "predev": "npm run build:packages",
+    "dev": "next dev -p 3940",
+    "build": "next build",
+    "start": "next start -p 3940",
+    "lint": "next lint",
+    "version:patch": "node scripts/bump-versions.mjs patch && node scripts/sync-versions.mjs && shx rm -rf node_modules src/*/node_modules package-lock.json && npm install --legacy-peer-deps",
+    "version:minor": "node scripts/bump-versions.mjs minor && node scripts/sync-versions.mjs && shx rm -rf node_modules src/*/node_modules package-lock.json && npm install --legacy-peer-deps",
+    "version:major": "node scripts/bump-versions.mjs major && node scripts/sync-versions.mjs && shx rm -rf node_modules src/*/node_modules package-lock.json && npm install --legacy-peer-deps",
+    "version:set": "npm version -ws && node scripts/sync-versions.mjs",
+    "sync:versions": "node scripts/sync-versions.mjs",
+    "prepublishOnly": "npm run clean:packages && npm run build:packages && npm run build:cli",
+    "publish:packages": "npm run prepublishOnly && node scripts/publish-workspaces.mjs",
+    "publish:root": "npm publish --access public",
+    "publish:all": "npm run prepublishOnly && node scripts/publish-workspaces.mjs && npm publish --access public --ignore-scripts",
+    "publish:dry": "npm run prepublishOnly && node scripts/publish-workspaces.mjs --dry-run && npm publish --access public --dry-run --ignore-scripts",
+    "docker:build": "docker build -t jgwill/medicine-wheel:app .",
+    "docker:push": "docker push jgwill/medicine-wheel:app",
+    "docker:build-push": "npm run docker:build && npm run docker:push",
+    "release:commit": "node scripts/release-commit.mjs",
+    "release:patch": "npm run version:patch && npm run publish:all && npm run release:commit",
+    "release:minor": "npm run version:minor && npm run publish:all && npm run release:commit",
+    "release:major": "npm run version:major && npm run publish:all && npm run release:commit"
+  },
+  "dependencies": {
+    "next": "^15.3.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "next-themes": "^0.4.6",
+    "sonner": "^1.7.0",
+    "lucide-react": "^0.475.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.0.2",
+    "recharts": "^2.15.4",
+    "@medicine-wheel/ontology-core": "^0.2.3",
+    "@medicine-wheel/ceremony-protocol": "^0.2.3",
+    "@medicine-wheel/narrative-engine": "^0.2.3",
+    "@medicine-wheel/graph-viz": "^0.2.3",
+    "@medicine-wheel/relational-query": "^0.2.3",
+    "@medicine-wheel/prompt-decomposition": "^0.2.3",
+    "@medicine-wheel/ui-components": "^0.2.3",
+    "@medicine-wheel/data-store": "^0.2.3",
+    "@medicine-wheel/session-reader": "^0.2.3",
+    "@medicine-wheel/fire-keeper": "^0.2.3",
+    "@medicine-wheel/importance-unit": "^0.2.3",
+    "@medicine-wheel/relational-index": "^0.2.3",
+    "@medicine-wheel/transformation-tracker": "^0.2.3",
+    "@medicine-wheel/storage-provider": "^0.2.3",
+    "@medicine-wheel/community-review": "^0.2.3",
+    "@medicine-wheel/consent-lifecycle": "^0.2.3",
+    "@medicine-wheel/data-store-postgres": "^0.2.3",
+    "@medicine-wheel/mcp": "^4.0.0",
+    "@neondatabase/serverless": "^0.10.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.1.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "shx": "^0.4.0",
+    "tailwindcss": "^4.1.0",
+    "typescript": "^5.7.0"
+  }
+}

package/postcss.config.mjs

@@ -0,0 +1,6 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+export default config;

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./*"] }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules", "src", "mcp"]
+}