@medicine-wheel/app 0.4.13 → 0.5.1

package/app/narrative/cycles/page.tsx

@@ -2,10 +2,13 @@
 
 import { useEffect, useState } from "react";
 import type { FormEvent } from "react";
-import { type MedicineWheelCycle, DIRECTION_COLORS, type DirectionName } from "@/lib/types";
+import { type MedicineWheelCycle, type DirectionName } from "@/lib/types";
 import { extractCycles } from "@/lib/cycle-response";
 import { toast } from "sonner";
 
+const dirVar = (d: string) => `var(--mw-${d})`;
+const dirInk = (d: string) => `var(--mw-${d}-ink)`;
+
 export default function CyclesPage() {
   const [cycles, setCycles] = useState<MedicineWheelCycle[]>([]);
   const [showForm, setShowForm] = useState(false);
@@ -28,7 +31,7 @@ export default function CyclesPage() {
       setShowForm(false);
       const data = await fetch("/api/narrative/cycles").then((r) => r.json());
       setCycles(extractCycles(data));
-    } else { toast.error("Failed"); }
+    } else { toast.error("Could not create the cycle — try again"); }
   }
 
   const dirOrder: DirectionName[] = ["east", "south", "west", "north"];
@@ -37,18 +40,18 @@ export default function CyclesPage() {
     <div className="p-6 max-w-5xl mx-auto">
       <div className="flex items-center justify-between mb-6">
         <div>
-          <h1 className="text-2xl font-bold">Medicine Wheel Cycles</h1>
+          <h1 className="mw-h1">Cycles</h1>
           <p className="text-sm text-muted-foreground">{cycles.length} research cycles</p>
         </div>
-        <button onClick={() => setShowForm(!showForm)} className="px-4 py-1.5 rounded-md bg-primary text-primary-foreground text-sm font-medium">+ New Cycle</button>
+        <button onClick={() => setShowForm(!showForm)} className="px-4 py-1.5 rounded-md bg-primary text-primary-foreground text-sm font-medium hover:opacity-90">New cycle</button>
       </div>
 
       {showForm && (
         <form onSubmit={createCycle} className="mb-6 p-4 border rounded-lg bg-card">
           <textarea name="question" placeholder="What is your research question?" rows={3} required className="w-full px-3 py-2 rounded-md border bg-background text-sm mb-3" />
           <div className="flex gap-2">
-            <button type="submit" className="px-4 py-2 rounded-md bg-primary text-primary-foreground text-sm">Create Cycle</button>
-            <button type="button" onClick={() => setShowForm(false)} className="px-4 py-2 rounded-md border text-sm">Cancel</button>
+            <button type="submit" className="px-4 py-2 rounded-md bg-primary text-primary-foreground text-sm hover:opacity-90">Create cycle</button>
+            <button type="button" onClick={() => setShowForm(false)} className="px-4 py-2 rounded-md border text-sm hover:bg-secondary/60">Cancel</button>
           </div>
         </form>
       )}
@@ -78,7 +81,7 @@ export default function CyclesPage() {
                       return (
                         <path key={dir}
                           d={`M 24 24 L ${x1} ${y1} A 20 20 0 0 1 ${x2} ${y2} Z`}
-                          fill={DIRECTION_COLORS[dir]}
+                          fill={dirVar(dir)}
                           opacity={completed ? 0.9 : 0.2}
                         />
                       );
@@ -89,7 +92,7 @@ export default function CyclesPage() {
                   <div className="flex-1 min-w-0">
                     <h3 className="font-semibold mb-1">{cycle.research_question}</h3>
                     <div className="flex items-center gap-4 text-sm text-muted-foreground">
-                      <span className="capitalize" style={{ color: DIRECTION_COLORS[cycle.current_direction as DirectionName] }}>
+                      <span className="capitalize" style={{ color: dirInk(cycle.current_direction) }}>
                         ● {cycle.current_direction}
                       </span>
                       <span>{cycle.beats.length} beats</span>
@@ -101,7 +104,7 @@ export default function CyclesPage() {
                     <div className="mt-3 h-2 bg-secondary rounded-full overflow-hidden">
                       <div className="h-full rounded-full transition-all" style={{
                         width: `${progress}%`,
-                        background: `linear-gradient(to right, ${DIRECTION_COLORS.east}, ${DIRECTION_COLORS.south}, ${DIRECTION_COLORS.west}, ${DIRECTION_COLORS.north})`,
+                        background: "linear-gradient(to right, var(--mw-east), var(--mw-south), var(--mw-west), var(--mw-north))",
                       }} />
                     </div>
                   </div>
@@ -114,7 +117,7 @@ export default function CyclesPage() {
                     {dirOrder.map((dir) => {
                       const active = dirOrder.indexOf(dir) <= dirIdx;
                       return (
-                        <div key={dir} className="text-center p-2 rounded-md border" style={{ borderColor: active ? DIRECTION_COLORS[dir] : "var(--color-border)", opacity: active ? 1 : 0.4 }}>
+                        <div key={dir} className="text-center p-2 rounded-md border" style={{ borderColor: active ? dirVar(dir) : "var(--color-border)", opacity: active ? 1 : 0.4 }}>
                           <p className="text-xs capitalize font-medium">{dir}</p>
                           <p className="text-sm">{active ? "✓" : "○"}</p>
                         </div>

package/app/narrative/layout.tsx

@@ -0,0 +1,9 @@
+import type { Metadata } from "next";
+
+export const metadata: Metadata = {
+  title: { default: "Narrative", template: "%s · Medicine Wheel" },
+};
+
+export default function NarrativeLayout({ children }: { children: React.ReactNode }) {
+  return children;
+}

package/app/narrative/page.tsx

@@ -1,10 +1,13 @@
 "use client";
 
 import { useEffect, useState } from "react";
-import { type NarrativeBeat, type MedicineWheelCycle, DIRECTION_COLORS, type DirectionName } from "@/lib/types";
+import { type NarrativeBeat, type MedicineWheelCycle, type DirectionName } from "@/lib/types";
 import { extractCycles } from "@/lib/cycle-response";
 import { relativeTime, absoluteTime } from "@/lib/format-time";
 
+const dirVar = (d: string) => `var(--mw-${d})`;
+const dirInk = (d: string) => `var(--mw-${d}-ink)`;
+
 export default function NarrativePage() {
   const [beats, setBeats] = useState<NarrativeBeat[]>([]);
   const [cycles, setCycles] = useState<MedicineWheelCycle[]>([]);
@@ -25,7 +28,7 @@ export default function NarrativePage() {
 
   return (
     <div className="p-6 max-w-5xl mx-auto">
-      <h1 className="text-2xl font-bold mb-2">Narrative Arc</h1>
+      <h1 className="mw-h1 mb-2">Narrative arc</h1>
       <p className="text-sm text-muted-foreground mb-6">Journey through the Four Directions</p>
 
       {activeCycle && (
@@ -40,7 +43,7 @@ export default function NarrativePage() {
           <div className="grid grid-cols-2 md:grid-cols-4 gap-4 text-center">
             <div>
               <p className="text-sm text-muted-foreground">Current Direction</p>
-              <p className="text-lg font-bold capitalize" style={{ color: DIRECTION_COLORS[activeCycle.current_direction as DirectionName] }}>
+              <p className="text-lg font-bold capitalize" style={{ color: dirInk(activeCycle.current_direction) }}>
                 {activeCycle.current_direction}
               </p>
             </div>
@@ -59,7 +62,7 @@ export default function NarrativePage() {
           </div>
           <div className="mt-4">
             <div className="h-2 bg-secondary rounded-full overflow-hidden">
-              <div className="h-full rounded-full transition-all" style={{ width: `${progress}%`, background: `linear-gradient(to right, ${DIRECTION_COLORS.east}, ${DIRECTION_COLORS.south}, ${DIRECTION_COLORS.west}, ${DIRECTION_COLORS.north})` }} />
+              <div className="h-full rounded-full transition-all" style={{ width: `${progress}%`, background: "linear-gradient(to right, var(--mw-east), var(--mw-south), var(--mw-west), var(--mw-north))" }} />
             </div>
             <div className="flex justify-between mt-1 text-xs text-muted-foreground">
               {dirOrder.map((d) => <span key={d} className="capitalize">{d}</span>)}
@@ -73,8 +76,8 @@ export default function NarrativePage() {
         {dirOrder.map((dir) => {
           const count = beats.filter((b) => b.direction === dir).length;
           return (
-            <div key={dir} className="p-3 rounded-lg border text-center" style={{ borderColor: DIRECTION_COLORS[dir] + "40" }}>
-              <span className="w-3 h-3 rounded-full inline-block mb-1" style={{ backgroundColor: DIRECTION_COLORS[dir] }} />
+            <div key={dir} className="p-3 rounded-lg border text-center" style={{ borderColor: `var(--mw-${dir}-border)` }}>
+              <span className="w-3 h-3 rounded-full inline-block mb-1" style={{ backgroundColor: dirVar(dir) }} />
               <p className="text-sm capitalize font-medium">{dir}</p>
               <p className="text-lg font-bold">{count}</p>
               <p className="text-xs text-muted-foreground">beats</p>
@@ -87,10 +90,10 @@ export default function NarrativePage() {
       <h2 className="text-lg font-semibold mb-3">Narrative Beats ({beats.length})</h2>
       <div className="space-y-3">
         {loading && <div className="text-center py-8 text-muted-foreground">Loading narrative beats…</div>}
-        {!loading && beats.length === 0 && <div className="text-center py-8 text-muted-foreground">No beats recorded yet.</div>}
+        {!loading && beats.length === 0 && <div className="text-center py-8 text-muted-foreground">No beats yet. Record the first one on the Beats page to begin the arc.</div>}
         {!loading && beats.map((beat) => (
           <div key={beat.id} className="border rounded-lg bg-card overflow-hidden cursor-pointer hover:border-ring/50"
-            style={{ borderLeftColor: DIRECTION_COLORS[beat.direction as DirectionName], borderLeftWidth: 4 }}
+            style={{ borderLeftColor: dirVar(beat.direction), borderLeftWidth: 4 }}
             onClick={() => setExpandedBeat(expandedBeat === beat.id ? null : beat.id)}>
             <div className="p-4">
               <div className="flex items-center justify-between">

package/app/nodes/page.tsx

@@ -1,25 +1,40 @@
 "use client";
 
 import { useEffect, useState, useCallback } from "react";
-import type { FormEvent } from "react";
+import type { SubmitEvent } from "react";
+import Link from "next/link";
 import {
   type RelationalNode,
   type RelationalEdge,
   type NodeType,
   type DirectionName,
-  NODE_TYPE_COLORS,
-  DIRECTION_COLORS,
 } from "@/lib/types";
 import { relativeTime, absoluteTime } from "@/lib/format-time";
 import { toast } from "sonner";
 
+// Storage returns description at the top level; legacy nodes carried it in metadata.
+type NodeRecord = RelationalNode & { description?: string };
+
 const NODE_TYPES: NodeType[] = ["human", "land", "spirit", "ancestor", "future", "knowledge"];
 const DIRECTIONS: DirectionName[] = ["east", "south", "west", "north"];
 const NODE_TYPE_ICONS: Record<NodeType, string> = { human: "👤", land: "🌍", spirit: "✨", ancestor: "🪶", future: "🌱", knowledge: "📚" };
 const DIRECTION_ICONS: Record<DirectionName, string> = { east: "🌅", south: "🌞", west: "🌄", north: "❄️" };
 
+function describeNode(node: NodeRecord): string {
+  return node.description || (typeof node.metadata?.description === "string" ? node.metadata.description : "");
+}
+
+function DirectionChip({ direction }: { direction?: DirectionName }) {
+  if (!direction) return <span className="mw-badge">no direction</span>;
+  return (
+    <span className={`mw-badge mw-badge--${direction}`}>
+      {DIRECTION_ICONS[direction]} {direction}
+    </span>
+  );
+}
+
 export default function NodesPage() {
-  const [nodes, setNodes] = useState<RelationalNode[]>([]);
+  const [nodes, setNodes] = useState<NodeRecord[]>([]);
   const [edges, setEdges] = useState<RelationalEdge[]>([]);
   const [loading, setLoading] = useState(true);
   const [filterType, setFilterType] = useState<string>("all");
@@ -28,6 +43,9 @@ export default function NodesPage() {
   const [expandedNode, setExpandedNode] = useState<string | null>(null);
   const [showAddNode, setShowAddNode] = useState(false);
   const [focusedNodeId, setFocusedNodeId] = useState<string | null>(null);
+  const [editingNode, setEditingNode] = useState<string | null>(null);
+  const [deletingNode, setDeletingNode] = useState<NodeRecord | null>(null);
+  const [busy, setBusy] = useState(false);
 
   const loadNodes = useCallback(async () => {
     setLoading(true);
@@ -42,13 +60,13 @@ export default function NodesPage() {
       ]);
       const nodesResponse = await nodesRes.json();
       const edgesData: RelationalEdge[] = edgesRes.ok ? await edgesRes.json() : [];
-      
+
       // API returns { nodes: [...], provider: '...', count: N }
-      const nodesData: RelationalNode[] = Array.isArray(nodesResponse) ? nodesResponse : (nodesResponse.nodes || []);
+      const nodesData: NodeRecord[] = Array.isArray(nodesResponse) ? nodesResponse : (nodesResponse.nodes || []);
       setNodes(nodesData);
       setEdges(Array.isArray(edgesData) ? edgesData : []);
     } catch {
-      toast.error("Failed to load nodes");
+      toast.error("Nodes did not load — check the connection and try again");
     } finally {
       setLoading(false);
     }
@@ -79,23 +97,74 @@ export default function NodesPage() {
     return node.name.toLowerCase().includes(q) || node.type.toLowerCase().includes(q) || (node.direction && node.direction.toLowerCase().includes(q));
   });
 
-  async function addNode(e: FormEvent<HTMLFormElement>) {
+  function relationsOf(nodeId: string): RelationalEdge[] {
+    return edges.filter((e) => e.from_id === nodeId || e.to_id === nodeId);
+  }
+
+  async function addNode(e: SubmitEvent<HTMLFormElement>) {
     e.preventDefault();
     const form = new FormData(e.currentTarget);
-    const description = form.get("description") as string;
     const body = {
       name: form.get("name") as string,
       type: form.get("type") as string,
       direction: (form.get("direction") as string) || undefined,
-      metadata: description ? { description } : {},
+      description: (form.get("description") as string) || undefined,
     };
+    setBusy(true);
     try {
       const res = await fetch("/api/nodes", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body) });
-      if (!res.ok) throw new Error("Failed");
-      toast.success("Node created");
+      const data = await res.json();
+      if (!res.ok) throw new Error(data.error || "Node was not created");
+      toast.success(`Node "${data.node.name}" joined the wheel`);
       setShowAddNode(false);
       loadNodes();
-    } catch { toast.error("Failed to create node"); }
+    } catch (err) {
+      toast.error(err instanceof Error ? err.message : "Node was not created");
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  async function saveNode(e: SubmitEvent<HTMLFormElement>, node: NodeRecord) {
+    e.preventDefault();
+    const form = new FormData(e.currentTarget);
+    const direction = form.get("direction") as string;
+    const body = {
+      name: form.get("name") as string,
+      type: form.get("type") as string,
+      description: (form.get("description") as string) ?? "",
+      direction: direction === "" ? null : direction,
+    };
+    setBusy(true);
+    try {
+      const res = await fetch(`/api/nodes/${node.id}`, { method: "PATCH", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body) });
+      const data = await res.json();
+      if (!res.ok) throw new Error(data.issues?.join("; ") || data.error || "Changes were not saved");
+      toast.success(`Changes to "${data.node.name}" saved`);
+      setEditingNode(null);
+      loadNodes();
+    } catch (err) {
+      toast.error(err instanceof Error ? err.message : "Changes were not saved");
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  async function deleteNode(node: NodeRecord) {
+    setBusy(true);
+    try {
+      const res = await fetch(`/api/nodes/${node.id}`, { method: "DELETE" });
+      const data = await res.json();
+      if (!res.ok) throw new Error(data.error || "Node was not deleted");
+      toast.success(`Node "${node.name}" released from the wheel`);
+      setDeletingNode(null);
+      setExpandedNode(null);
+      loadNodes();
+    } catch (err) {
+      toast.error(err instanceof Error ? err.message : "Node was not deleted");
+    } finally {
+      setBusy(false);
+    }
   }
 
   const typeCounts = NODE_TYPES.reduce((acc, t) => { acc[t] = nodes.filter((n) => n.type === t).length; return acc; }, {} as Record<NodeType, number>);
@@ -104,30 +173,44 @@ export default function NodesPage() {
     <div className="p-6 max-w-7xl mx-auto">
       <div className="flex items-center justify-between mb-6">
         <div>
-          <h1 className="text-2xl font-bold">🔗 Relational Nodes</h1>
+          <h1 className="text-2xl font-bold">Nodes</h1>
           <p className="text-sm text-muted-foreground">{nodes.length} nodes in the relational web</p>
         </div>
-        <button onClick={() => setShowAddNode(!showAddNode)} className="px-4 py-2 rounded-md bg-primary text-primary-foreground text-sm font-medium">+ Add Node</button>
+        <button onClick={() => setShowAddNode(!showAddNode)} className="mw-btn mw-btn--primary">
+          {showAddNode ? "Close form" : "Create node"}
+        </button>
       </div>
 
       {showAddNode && (
         <form onSubmit={addNode} className="mb-6 p-4 border rounded-lg bg-card space-y-3">
           <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
-            <input name="name" placeholder="Node name" required className="px-3 py-2 rounded-md border bg-background text-sm" />
-            <select name="type" required className="px-3 py-2 rounded-md border bg-background text-sm">
-              {NODE_TYPES.map((t) => <option key={t} value={t}>{NODE_TYPE_ICONS[t]} {t}</option>)}
-            </select>
+            <label className="text-sm space-y-1">
+              <span className="text-muted-foreground">Name</span>
+              <input name="name" placeholder="Who or what joins the wheel?" required className="mw-input" />
+            </label>
+            <label className="text-sm space-y-1">
+              <span className="text-muted-foreground">Type</span>
+              <select name="type" required className="mw-input">
+                {NODE_TYPES.map((t) => <option key={t} value={t}>{NODE_TYPE_ICONS[t]} {t}</option>)}
+              </select>
+            </label>
           </div>
           <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
-            <select name="direction" className="px-3 py-2 rounded-md border bg-background text-sm">
-              <option value="">No direction</option>
-              {DIRECTIONS.map((d) => <option key={d} value={d}>{DIRECTION_ICONS[d]} {d}</option>)}
-            </select>
-            <input name="description" placeholder="Description (optional)" className="px-3 py-2 rounded-md border bg-background text-sm" />
+            <label className="text-sm space-y-1">
+              <span className="text-muted-foreground">Direction</span>
+              <select name="direction" className="mw-input">
+                <option value="">No direction</option>
+                {DIRECTIONS.map((d) => <option key={d} value={d}>{DIRECTION_ICONS[d]} {d}</option>)}
+              </select>
+            </label>
+            <label className="text-sm space-y-1">
+              <span className="text-muted-foreground">Description</span>
+              <input name="description" placeholder="What this node carries (optional)" className="mw-input" />
+            </label>
           </div>
           <div className="flex gap-2">
-            <button type="submit" className="px-4 py-2 rounded-md bg-primary text-primary-foreground text-sm">Create Node</button>
-            <button type="button" onClick={() => setShowAddNode(false)} className="px-4 py-2 rounded-md border text-sm">Cancel</button>
+            <button type="submit" disabled={busy} className="mw-btn mw-btn--primary">Create node</button>
+            <button type="button" onClick={() => setShowAddNode(false)} className="mw-btn mw-btn--ghost">Cancel</button>
           </div>
         </form>
       )}
@@ -135,89 +218,180 @@ export default function NodesPage() {
       <div className="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-6 gap-3 mb-6">
         {NODE_TYPES.map((t) => (
           <button key={t} onClick={() => setFilterType(filterType === t ? "all" : t)}
+            aria-pressed={filterType === t}
             className={`p-3 rounded-lg border text-center transition-all ${filterType === t ? "ring-2 ring-primary bg-secondary" : "hover:bg-secondary/50"}`}>
             <div className="text-2xl mb-1">{NODE_TYPE_ICONS[t]}</div>
             <div className="text-sm font-medium capitalize">{t}</div>
-            <div className="text-lg font-bold" style={{ color: NODE_TYPE_COLORS[t] }}>{typeCounts[t]}</div>
+            <div className="text-lg font-bold" style={{ color: `var(--mw-node-${t})` }}>{typeCounts[t]}</div>
           </button>
         ))}
       </div>
 
       <div className="flex flex-wrap gap-3 mb-6">
-        <input type="text" placeholder="Search nodes..." value={searchQuery} onChange={(e) => setSearchQuery(e.target.value)} className="px-3 py-2 rounded-md border bg-background text-sm flex-1 min-w-[200px]" />
-        <select value={filterDirection} onChange={(e) => setFilterDirection(e.target.value)} className="px-3 py-2 rounded-md border bg-background text-sm">
-          <option value="all">All Directions</option>
+        <input type="text" placeholder="Search nodes…" value={searchQuery} onChange={(e) => setSearchQuery(e.target.value)} className="mw-input flex-1 min-w-[200px]" style={{ width: "auto" }} />
+        <select value={filterDirection} onChange={(e) => setFilterDirection(e.target.value)} className="mw-input" style={{ width: "auto" }}>
+          <option value="all">All directions</option>
           {DIRECTIONS.map((d) => <option key={d} value={d}>{DIRECTION_ICONS[d]} {d}</option>)}
         </select>
         {(filterType !== "all" || filterDirection !== "all" || searchQuery) && (
-          <button onClick={() => { setFilterType("all"); setFilterDirection("all"); setSearchQuery(""); }} className="px-3 py-2 rounded-md border text-sm text-muted-foreground hover:text-foreground">Clear filters</button>
+          <button onClick={() => { setFilterType("all"); setFilterDirection("all"); setSearchQuery(""); }} className="mw-btn mw-btn--ghost">Clear filters</button>
         )}
       </div>
 
       {loading ? (
-        <div className="text-center py-12 text-muted-foreground">Loading nodes...</div>
+        <div className="text-center py-12 text-muted-foreground">Loading nodes…</div>
       ) : filteredNodes.length === 0 ? (
         <div className="text-center py-12 text-muted-foreground">
-          <p>No nodes found</p>
-          {(filterType !== "all" || filterDirection !== "all" || searchQuery) && <p className="text-sm mt-2">Try adjusting your filters</p>}
+          {nodes.length === 0 ? (
+            <>
+              <p>The wheel holds no nodes yet.</p>
+              <button onClick={() => setShowAddNode(true)} className="mw-btn mw-btn--primary mt-4">Create the first node</button>
+            </>
+          ) : (
+            <>
+              <p>No nodes match these filters.</p>
+              <p className="text-sm mt-2">Loosen the search or clear the filters to see the full circle.</p>
+            </>
+          )}
         </div>
       ) : (
         <div className="space-y-2">
-          {filteredNodes.map((node) => (
-            <div
-              key={node.id}
-              id={`node-${node.id}`}
-              className={`border rounded-lg bg-card overflow-hidden transition-all ${expandedNode === node.id ? "ring-2 ring-primary" : ""}`}
-            >
-              <button
-                onClick={() => setExpandedNode(expandedNode === node.id ? null : node.id)}
-                className="w-full px-4 py-3 flex items-center gap-3 text-left hover:bg-secondary/30"
+          {filteredNodes.map((node) => {
+            const nodeRelations = relationsOf(node.id);
+            const isExpanded = expandedNode === node.id;
+            const isEditing = editingNode === node.id;
+            return (
+              <div
+                key={node.id}
+                id={`node-${node.id}`}
+                className={`border rounded-lg bg-card overflow-hidden transition-all ${isExpanded ? "ring-2 ring-primary" : ""}`}
               >
-                <span className="w-10 h-10 rounded-full flex items-center justify-center text-xl" style={{ backgroundColor: NODE_TYPE_COLORS[node.type] + "30" }}>
-                  {NODE_TYPE_ICONS[node.type]}
-                </span>
-                <div className="flex-1 min-w-0">
-                  <div className="font-medium truncate">{node.name}</div>
-                  <div className="text-sm text-muted-foreground flex gap-2">
-                    <span className="capitalize">{node.type}</span>
-                    {node.direction && (
+                <button
+                  onClick={() => { setExpandedNode(isExpanded ? null : node.id); if (!isExpanded) setEditingNode(null); }}
+                  aria-expanded={isExpanded}
+                  className="w-full px-4 py-3 flex items-center gap-3 text-left hover:bg-secondary/30"
+                >
+                  <span className="w-10 h-10 rounded-full flex items-center justify-center text-xl" style={{ backgroundColor: `color-mix(in srgb, var(--mw-node-${node.type}) 20%, transparent)` }}>
+                    {NODE_TYPE_ICONS[node.type]}
+                  </span>
+                  <div className="flex-1 min-w-0">
+                    <div className="font-medium truncate">{node.name}</div>
+                    <div className="text-sm text-muted-foreground flex items-center gap-2">
+                      <span className="capitalize">{node.type}</span>
+                      <DirectionChip direction={node.direction} />
+                      {nodeRelations.length > 0 && <span>{nodeRelations.length} relation{nodeRelations.length === 1 ? "" : "s"}</span>}
+                    </div>
+                  </div>
+                  <span className="text-muted-foreground" aria-hidden>{isExpanded ? "▲" : "▼"}</span>
+                </button>
+
+                {isExpanded && (
+                  <div className="border-t p-4 space-y-3">
+                    {isEditing ? (
+                      <form onSubmit={(e) => saveNode(e, node)} className="space-y-3">
+                        <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
+                          <label className="text-sm space-y-1">
+                            <span className="text-muted-foreground">Name</span>
+                            <input name="name" defaultValue={node.name} required className="mw-input" />
+                          </label>
+                          <label className="text-sm space-y-1">
+                            <span className="text-muted-foreground">Type</span>
+                            <select name="type" defaultValue={node.type} className="mw-input">
+                              {NODE_TYPES.map((t) => <option key={t} value={t}>{NODE_TYPE_ICONS[t]} {t}</option>)}
+                            </select>
+                          </label>
+                        </div>
+                        <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
+                          <label className="text-sm space-y-1">
+                            <span className="text-muted-foreground">Direction</span>
+                            <select name="direction" defaultValue={node.direction ?? ""} className="mw-input">
+                              <option value="">No direction</option>
+                              {DIRECTIONS.map((d) => <option key={d} value={d}>{DIRECTION_ICONS[d]} {d}</option>)}
+                            </select>
+                          </label>
+                          <label className="text-sm space-y-1">
+                            <span className="text-muted-foreground">Description</span>
+                            <input name="description" defaultValue={describeNode(node)} placeholder="What this node carries" className="mw-input" />
+                          </label>
+                        </div>
+                        <div className="flex gap-2">
+                          <button type="submit" disabled={busy} className="mw-btn mw-btn--primary">Save changes</button>
+                          <button type="button" onClick={() => setEditingNode(null)} className="mw-btn mw-btn--ghost">Cancel</button>
+                        </div>
+                      </form>
+                    ) : (
                       <>
-                        <span>·</span>
-                        <span className="capitalize" style={{ color: DIRECTION_COLORS[node.direction] }}>{DIRECTION_ICONS[node.direction]} {node.direction}</span>
+                        {describeNode(node) && <p className="text-sm">{describeNode(node)}</p>}
+                        <div className="grid grid-cols-2 gap-4 text-sm">
+                          <div><span className="text-muted-foreground">Type:</span> <span className="capitalize">{node.type}</span></div>
+                          <div><span className="text-muted-foreground">Direction:</span> <DirectionChip direction={node.direction} /></div>
+                          <div><span className="text-muted-foreground">Created:</span> <span title={absoluteTime(node.created_at)}>{relativeTime(node.created_at)}</span></div>
+                          <div><span className="text-muted-foreground">ID:</span> <code className="text-xs">{node.id.slice(0, 8)}…</code></div>
+                        </div>
+                        <div>
+                          <h4 className="text-sm font-medium mb-2">Relations ({nodeRelations.length})</h4>
+                          {nodeRelations.length === 0 ? (
+                            <p className="text-sm text-muted-foreground">
+                              No relations yet — <Link href="/relations" className="underline hover:text-foreground">weave one on the relations page</Link>.
+                            </p>
+                          ) : (
+                            nodeRelations.map((e) => {
+                              const otherId = e.from_id === node.id ? e.to_id : e.from_id;
+                              const other = nodes.find((n) => n.id === otherId);
+                              return (
+                                <div key={`${e.from_id}:${e.to_id}`} className="py-1 text-sm border-b border-border/50 flex items-center gap-2">
+                                  <span className="text-muted-foreground">{e.relationship_type}</span>
+                                  <span aria-hidden>{e.from_id === node.id ? "→" : "←"}</span>
+                                  {other?.name || "?"}
+                                  <span className="text-xs text-muted-foreground">({Math.round(e.strength * 100)}%)</span>
+                                  {e.ceremony_honored && <span style={{ color: "var(--mw-ceremony)" }} title="Ceremony honored">✦</span>}
+                                </div>
+                              );
+                            })
+                          )}
+                        </div>
+                        <div className="flex gap-2 pt-1">
+                          <button onClick={() => setEditingNode(node.id)} className="mw-btn mw-btn--secondary">Edit node</button>
+                          <Link href={`/graph?node=${node.id}`} className="mw-btn mw-btn--ghost">See on the wheel</Link>
+                          <button onClick={() => setDeletingNode(node)} className="mw-btn mw-btn--danger">Delete node</button>
+                        </div>
                       </>
                     )}
                   </div>
+                )}
+              </div>
+            );
+          })}
+        </div>
+      )}
+
+      {deletingNode && (
+        <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/60 p-4" role="dialog" aria-modal="true" aria-labelledby="delete-node-title">
+          <div className="w-full max-w-md rounded-lg border bg-card p-6 space-y-4">
+            <h2 id="delete-node-title" className="text-lg font-semibold">Delete “{deletingNode.name}”?</h2>
+            {relationsOf(deletingNode.id).length > 0 ? (
+              <>
+                <p className="text-sm">
+                  This node holds {relationsOf(deletingNode.id).length} relation{relationsOf(deletingNode.id).length === 1 ? "" : "s"} — release them first.
+                  Relations are severed consciously, never cascaded.
+                </p>
+                <div className="flex gap-2 justify-end">
+                  <button onClick={() => setDeletingNode(null)} className="mw-btn mw-btn--ghost">Keep the node</button>
+                  <Link href={`/relations?node=${deletingNode.id}`} className="mw-btn mw-btn--primary">Review its relations</Link>
                 </div>
-                <span className="text-muted-foreground">{expandedNode === node.id ? "▲" : "▼"}</span>
-              </button>
-
-              {expandedNode === node.id && (
-                <div className="border-t p-4 space-y-3">
-                  <div className="grid grid-cols-2 gap-4 text-sm">
-                    <div><span className="text-muted-foreground">Type:</span> <span className="capitalize">{node.type}</span></div>
-                    {node.direction && <div><span className="text-muted-foreground">Direction:</span> <span className="capitalize">{node.direction}</span></div>}
-                    <div><span className="text-muted-foreground">Created:</span> <span title={absoluteTime(node.created_at)}>{relativeTime(node.created_at)}</span></div>
-                    <div><span className="text-muted-foreground">ID:</span> <code className="text-xs">{node.id.slice(0, 8)}…</code></div>
-                  </div>
-                  <div>
-                    <h4 className="text-sm font-medium mb-2">Connected Edges ({edges.filter((e) => e.from_id === node.id || e.to_id === node.id).length})</h4>
-                    {edges.filter((e) => e.from_id === node.id || e.to_id === node.id).map((e) => {
-                      const otherId = e.from_id === node.id ? e.to_id : e.from_id;
-                      const other = nodes.find((n) => n.id === otherId);
-                      return (
-                        <div key={e.id} className="py-1 text-sm border-b border-border/50 flex items-center gap-2">
-                          <span className="text-muted-foreground">{e.relationship_type}</span>
-                          → {other?.name || "?"}
-                          <span className="text-xs text-muted-foreground">({Math.round(e.strength * 100)}%)</span>
-                          {e.ceremony_honored && <span className="text-green-500">✓</span>}
-                        </div>
-                      );
-                    })}
-                  </div>
+              </>
+            ) : (
+              <>
+                <p className="text-sm">
+                  This node holds no relations. Deleting releases it from the wheel — this cannot be undone.
+                </p>
+                <div className="flex gap-2 justify-end">
+                  <button onClick={() => setDeletingNode(null)} className="mw-btn mw-btn--ghost">Keep the node</button>
+                  <button onClick={() => deleteNode(deletingNode)} disabled={busy} className="mw-btn mw-btn--danger border border-current">Delete node</button>
                 </div>
-              )}
-            </div>
-          ))}
+              </>
+            )}
+          </div>
         </div>
       )}
     </div>