@openephemeris/mcp-server 3.12.0 → 3.13.0

package/dist/tools/apps/bodygraph-app.js

@@ -0,0 +1,633 @@
+/**
+ * bodygraph-app.ts — MCP App tool registration for the Human Design Bodygraph Explorer.
+ *
+ * Registers 4 tools:
+ *   • explore_human_design      — primary entry point, returns data + UI resource [model]
+ *   • hd_on_center_click        — center click handler [app-only]
+ *   • hd_on_gate_click          — gate click handler [app-only]
+ *   • hd_on_channel_click       — channel click handler [app-only]
+ *
+ * The bodygraph is rendered client-side from structured JSON — no SVG endpoint
+ * is called, keeping latency at zero and the architecture consistent with
+ * the chart-wheel-app approach.
+ *
+ * Also exports resource helpers (getBodygraphBundle, etc.) for use in
+ * index.ts and server-sse.ts.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { registerTool } from "../index.js";
+import { getActiveClient } from "../../backend/client.js";
+// ── Constants ─────────────────────────────────────────────────────────────
+export const BODYGRAPH_RESOURCE_URI = "ui://openephemeris/bodygraph";
+export const BODYGRAPH_MIME_TYPE = "text/html;profile=mcp-app";
+const here = path.dirname(fileURLToPath(import.meta.url));
+const BUNDLE_PATHS = [
+    path.resolve(here, "..", "..", "..", "dist", "ui", "bodygraph.html"),
+];
+function findBundlePath() {
+    for (const p of BUNDLE_PATHS) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    return null;
+}
+let cachedBundle = null;
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export function getBodygraphBundle() {
+    if (cachedBundle)
+        return cachedBundle;
+    const bundlePath = findBundlePath();
+    if (!bundlePath)
+        return null;
+    try {
+        cachedBundle = fs.readFileSync(bundlePath, "utf-8");
+        return cachedBundle;
+    }
+    catch {
+        return null;
+    }
+}
+/** Reset cache (useful in dev watch mode or tests). */
+export function clearBodygraphBundleCache() {
+    cachedBundle = null;
+}
+// ── Helpers ──────────────────────────────────────────────────────────────
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/** Ensure datetime has a UTC offset for Go time.Time parsing. */
+function ensureTimezone(dt) {
+    if (!dt)
+        return dt;
+    if (/[Zz]$/.test(dt) || /[+-]\d{2}:\d{2}$/.test(dt))
+        return dt;
+    return dt + "Z";
+}
+const CENTER_ORDER = [
+    "Head", "Ajna", "Throat", "G", "Sacral",
+    "Heart", "Spleen", "Solar Plexus", "Root",
+];
+// Alternative center name spellings the API might return
+const CENTER_NAME_ALIASES = {
+    "self": "G",
+    "g center": "G",
+    "g-center": "G",
+    "ego": "Heart",
+    "heart": "Heart",
+    "will": "Heart",
+    "solar plexus": "Solar Plexus",
+    "emotional": "Solar Plexus",
+    "sp": "Solar Plexus",
+    "spleen": "Spleen",
+    "splenic": "Spleen",
+    "esp": "Solar Plexus",
+    "root": "Root",
+    "sacral": "Sacral",
+    "throat": "Throat",
+    "ajna": "Ajna",
+    "head": "Head",
+};
+function normalizeCenterName(raw) {
+    const lower = raw.toLowerCase().trim();
+    return CENTER_NAME_ALIASES[lower] ?? capitalize(raw.trim());
+}
+/**
+ * Extract valid gate numbers (1–64) from any gate-array shape the API might return.
+ * Hoisted to module scope to avoid per-call function allocation.
+ */
+function extractGateNums(arr) {
+    if (!Array.isArray(arr))
+        return [];
+    return arr
+        .map((g) => typeof g === "number" ? g : Number(g?.gate ?? g?.number ?? g))
+        .filter((n) => Number.isInteger(n) && n >= 1 && n <= 64);
+}
+/**
+ * Extract a lean HD model payload (< 2 KB) from the full API response.
+ * Strips raw planetary gate arrays; keeps only structural data needed by the UI.
+ */
+function buildHdModelPayload(data, birthParams) {
+    const type = String((data.type ?? data.hd_type ?? data.energy_type ?? "Unknown"));
+    const profile = String(data.profile ?? "");
+    const authority = String(data.authority ?? data.inner_authority ?? "");
+    const definition = String(data.definition ?? data.definition_type ?? "");
+    const incarnation_cross = String(data.incarnation_cross ?? data.cross ?? "");
+    // Normalize centers — API may return array or keyed object
+    let centers = [];
+    const rawCenters = data.centers;
+    if (Array.isArray(rawCenters)) {
+        centers = rawCenters.map((c) => ({
+            name: normalizeCenterName(String(c.name ?? c.center ?? "")),
+            defined: Boolean(c.defined ?? c.is_defined),
+        }));
+    }
+    else if (rawCenters && typeof rawCenters === "object") {
+        centers = Object.entries(rawCenters).map(([name, val]) => ({
+            name: normalizeCenterName(name),
+            defined: typeof val === "object" && val !== null
+                ? Boolean(val.defined ?? val.is_defined)
+                : Boolean(val),
+        }));
+    }
+    // Sort centers by canonical HD order
+    centers.sort((a, b) => {
+        const ai = CENTER_ORDER.indexOf(a.name);
+        const bi = CENTER_ORDER.indexOf(b.name);
+        if (ai !== -1 && bi !== -1)
+            return ai - bi;
+        if (ai !== -1)
+            return -1;
+        if (bi !== -1)
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+    // Compact active gate list — just gate numbers, no planets
+    const rawGates = data.active_gates ?? data.gates ?? data.defined_gates ?? [];
+    let active_gates = [];
+    if (Array.isArray(rawGates)) {
+        active_gates = rawGates
+            .map((g) => {
+            const n = typeof g === "number" ? g : Number(g?.gate ?? g?.number ?? g);
+            return Number.isInteger(n) && n >= 1 && n <= 64 ? n : null;
+        })
+            .filter((n) => n !== null)
+            .filter((n, i, arr) => arr.indexOf(n) === i) // unique
+            .sort((a, b) => a - b);
+    }
+    // Active channels as "gate1-gate2" strings
+    const rawChannels = data.active_channels ?? data.channels ?? data.defined_channels ?? [];
+    let active_channels = [];
+    if (Array.isArray(rawChannels)) {
+        active_channels = rawChannels.map((ch) => {
+            if (typeof ch === "string")
+                return ch;
+            const g1 = ch.gate1 ?? ch.from ?? ch.gates?.[0];
+            const g2 = ch.gate2 ?? ch.to ?? ch.gates?.[1];
+            return g1 != null && g2 != null ? `${g1}-${g2}` : String(ch);
+        });
+    }
+    // Personality / Design gate extraction (API may return multiple field name variants)
+    const rawP = data.personality_gates ?? data.personality ?? data.conscious_gates ?? [];
+    const rawD = data.design_gates ?? data.unconscious_gates ?? [];
+    const personality_gates = [...new Set(extractGateNums(rawP))].sort((a, b) => a - b);
+    const design_gates = [...new Set(extractGateNums(rawD))].sort((a, b) => a - b);
+    return {
+        type,
+        profile,
+        authority,
+        definition,
+        incarnation_cross,
+        centers,
+        active_gates,
+        active_channels,
+        personality_gates,
+        design_gates,
+        _birth_params: birthParams,
+    };
+}
+/**
+ * Format a human-readable summary from a pre-built HdModelPayload.
+ * Accepts the payload directly to avoid a redundant buildHdModelPayload call.
+ */
+function buildHdSummary(payload, location) {
+    const definedList = payload.centers.filter((c) => c.defined).map((c) => c.name);
+    const undefinedList = payload.centers.filter((c) => !c.defined).map((c) => c.name);
+    return (`**Human Design Chart \u2014 ${location}**\n\n` +
+        `Type: **${payload.type}**  |  Profile: **${payload.profile}**  |  Authority: **${payload.authority}**\n` +
+        `Definition: ${payload.definition}  |  Cross: ${payload.incarnation_cross}\n\n` +
+        `Defined Centers: ${definedList.length > 0 ? definedList.join(", ") : "None"}\n` +
+        `Undefined Centers: ${undefinedList.length > 0 ? undefinedList.join(", ") : "None"}\n\n` +
+        "Click any center, gate, or channel on the bodygraph for interpretation.");
+}
+// ── Tool: explore_human_design ────────────────────────────────────────────
+registerTool({
+    name: "explore_human_design",
+    description: "Generate an interactive Human Design Bodygraph with clickable centers, gates, and channels. " +
+        "Returns an embedded visual bodygraph explorer that lets you click any center or gate " +
+        "for instant Human Design interpretation. " +
+        "Shows defined/undefined centers, active gates, channels, Type, Profile, Authority, " +
+        "and Incarnation Cross. " +
+        "The chart is calculated using NASA JPL DE440 ephemerides for both Personality and Design positions. " +
+        "Use this for a rich, interactive HD experience in MCP Apps-capable hosts (Claude Desktop). " +
+        "Falls back to a text summary in other hosts.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            datetime: {
+                type: "string",
+                description: "ISO 8601 birth datetime in UTC, e.g. '1990-04-15T19:30:00Z'. " +
+                    "Human Design is time-sensitive — accuracy to the minute matters. " +
+                    "Include 'Z' or a timezone offset.",
+            },
+            latitude: {
+                type: "number",
+                description: "Birth latitude in decimal degrees (positive = North). Optional for HD charts.",
+            },
+            longitude: {
+                type: "number",
+                description: "Birth longitude in decimal degrees (positive = East). Optional for HD charts.",
+            },
+            location: {
+                type: "string",
+                description: "Location name for display only (e.g. 'New York, NY').",
+            },
+        },
+        required: ["datetime"],
+    },
+    annotations: {
+        title: "Interactive Human Design Bodygraph Explorer",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (args) => {
+        const client = getActiveClient();
+        const datetime = ensureTimezone(String(args.datetime));
+        const location = String(args.location ?? (args.latitude != null ? `${args.latitude}, ${args.longitude}` : "Unknown")).slice(0, 120);
+        const body = {
+            birth_datetime_utc: datetime,
+        };
+        if (args.latitude != null)
+            body.latitude = args.latitude;
+        if (args.longitude != null)
+            body.longitude = args.longitude;
+        const chartData = await client.request("POST", "/human-design/chart", {
+            data: body,
+        });
+        // Build payload once \u2014 summary and model data both derive from the same object
+        const modelPayload = buildHdModelPayload(chartData, {
+            datetime,
+            location: args.location ?? null,
+        });
+        const summary = buildHdSummary(modelPayload, location);
+        const bundleAvailable = Boolean(getBodygraphBundle());
+        if (bundleAvailable) {
+            return {
+                content: [
+                    { type: "text", text: summary },
+                    { type: "text", text: JSON.stringify(modelPayload) },
+                    {
+                        type: "resource",
+                        resource: {
+                            uri: BODYGRAPH_RESOURCE_URI,
+                            mimeType: BODYGRAPH_MIME_TYPE,
+                            text: "[Human Design Bodygraph Explorer UI]",
+                        },
+                    },
+                ],
+                _meta: {
+                    ui: { resourceUri: BODYGRAPH_RESOURCE_URI },
+                },
+            };
+        }
+        // Fallback: text summary only
+        return { content: [{ type: "text", text: summary }] };
+    },
+});
+// ── Tool: hd_on_center_click ──────────────────────────────────────────────
+registerTool({
+    name: "hd_on_center_click",
+    description: "Event handler called when the user clicks a center in the Human Design Bodygraph. " +
+        "Returns the center's defined or undefined themes, keynotes, biological correlates, " +
+        "and circuit associations. " +
+        "This tool is called automatically by the bodygraph UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            center: {
+                type: "string",
+                description: "Center name (e.g. 'Head', 'Ajna', 'Throat', 'G', 'Sacral', 'Heart', 'Spleen', 'Solar Plexus', 'Root')",
+            },
+            defined: {
+                type: "boolean",
+                description: "Whether the center is defined (colored) or undefined (open/white).",
+            },
+        },
+        required: ["center", "defined"],
+    },
+    annotations: { title: "Center Interpretation", readOnlyHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: BODYGRAPH_RESOURCE_URI, visibility: ["app"] } },
+    handler: async (args) => {
+        const center = String(args.center);
+        const defined = Boolean(args.defined);
+        const info = HD_CENTER_DATA[center] ?? HD_CENTER_DATA[normalizeCenterName(center)];
+        if (!info) {
+            return {
+                content: [{ type: "text", text: `**${center} Center**\n\nNo interpretation data available for this center.` }],
+            };
+        }
+        const defLine = defined
+            ? `**Defined** — ${info.defined_theme}`
+            : `**Undefined (Open)** — ${info.undefined_theme}`;
+        return {
+            content: [{
+                    type: "text",
+                    text: `**${center} Center** ${defined ? "🔴" : "⬜"}\n\n` +
+                        `${defLine}\n\n` +
+                        `**Keynote:** ${info.keynote}\n\n` +
+                        `**Biological Correlate:** ${info.biology}\n\n` +
+                        `**Circuit:** ${info.circuit}\n\n` +
+                        (defined
+                            ? `*Defined centers broadcast their energy consistently and reliably into the world.*`
+                            : `*Open centers receive and amplify external conditioning. They are areas of learning, not weakness.*`),
+                }],
+        };
+    },
+});
+// ── Tool: hd_on_gate_click ────────────────────────────────────────────────
+registerTool({
+    name: "hd_on_gate_click",
+    description: "Event handler called when the user clicks an active gate in the Human Design Bodygraph. " +
+        "Returns the gate's name, I Ching hexagram reference, keynote, and gift/shadow spectrum. " +
+        "This tool is called automatically by the bodygraph UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            gate: {
+                type: "number",
+                description: "Gate number (1–64).",
+            },
+            line: {
+                type: "number",
+                description: "I Ching line number (1–6). Optional.",
+            },
+            planet: {
+                type: "string",
+                description: "Planet activating this gate (e.g. 'sun', 'moon'). Optional.",
+            },
+            conscious: {
+                type: "boolean",
+                description: "True if Personality (conscious/black), false if Design (unconscious/red).",
+            },
+        },
+        required: ["gate"],
+    },
+    annotations: { title: "Gate Interpretation", readOnlyHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: BODYGRAPH_RESOURCE_URI, visibility: ["app"] } },
+    handler: async (args) => {
+        const gate = Number(args.gate);
+        const line = args.line != null ? Number(args.line) : null;
+        const planet = args.planet ? String(args.planet) : null;
+        const conscious = args.conscious != null ? Boolean(args.conscious) : null;
+        const info = HD_GATE_DATA[gate];
+        const lineRef = line ? `.${line}` : "";
+        const planetNote = planet ? ` (activated by ${capitalize(planet)})` : "";
+        const consciousNote = conscious === true ? " — **Personality** (conscious)" : conscious === false ? " — **Design** (unconscious)" : "";
+        if (!info) {
+            return {
+                content: [{ type: "text", text: `**Gate ${gate}${lineRef}**${planetNote}${consciousNote}\n\nGate data not available.` }],
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Gate ${gate}${lineRef} — ${info.name}**${planetNote}${consciousNote}\n\n` +
+                        `**I Ching Hexagram:** ${info.hexagram}\n\n` +
+                        `**Keynote:** ${info.keynote}\n\n` +
+                        `**Gift:** ${info.gift}\n\n` +
+                        `**Shadow:** ${info.shadow}\n\n` +
+                        `**Circuit:** ${info.circuit}` +
+                        (line ? `\n\n**Line ${line} Theme:** ${info.lines?.[line] ?? "Integration through lived experience."}` : ""),
+                }],
+        };
+    },
+});
+// ── Tool: hd_on_channel_click ─────────────────────────────────────────────
+registerTool({
+    name: "hd_on_channel_click",
+    description: "Event handler called when the user clicks an active channel in the Human Design Bodygraph. " +
+        "Returns the channel's name, the two gates it connects, its circuit, and energy type. " +
+        "This tool is called automatically by the bodygraph UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            channel: {
+                type: "string",
+                description: "Channel identifier string (e.g. '1-8', '20-34').",
+            },
+            gate1: {
+                type: "number",
+                description: "First gate number.",
+            },
+            gate2: {
+                type: "number",
+                description: "Second gate number.",
+            },
+        },
+        required: ["channel"],
+    },
+    annotations: { title: "Channel Interpretation", readOnlyHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: BODYGRAPH_RESOURCE_URI, visibility: ["app"] } },
+    handler: async (args) => {
+        const channelStr = String(args.channel);
+        const g1 = args.gate1 != null ? Number(args.gate1) : null;
+        const g2 = args.gate2 != null ? Number(args.gate2) : null;
+        // Normalise lookup key — try both gate orderings
+        const key = channelStr.includes("-") ? channelStr : g1 != null && g2 != null ? `${g1}-${g2}` : channelStr;
+        const info = HD_CHANNEL_DATA[key] ?? HD_CHANNEL_DATA[key.split("-").reverse().join("-")];
+        if (!info) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `**Channel ${channelStr}**\n\n` +
+                            `Gates ${g1 ?? "?"} and ${g2 ?? "?"} form a channel when both are active in the chart, ` +
+                            `connecting two centers and creating a defined circuit of energy flow.\n\n` +
+                            `Detailed channel data not available for this pairing.`,
+                    }],
+            };
+        }
+        const ENERGY_TYPE_DESCRIPTIONS = {
+            manifested: "This is a **Manifesting** channel — it can initiate and impact the world directly.",
+            generated: "This is a **Generated** channel — powered by sacral life-force, it sustains and builds.",
+            projected: "This is a **Projected** channel — it guides and directs rather than generates energy.",
+            reflected: "This is a **Reflected** channel — it samples and mirrors the whole.",
+        };
+        const energyDesc = ENERGY_TYPE_DESCRIPTIONS[info.energy_type.toLowerCase()] ?? `Energy type: ${info.energy_type}`;
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Channel ${channelStr} — ${info.name}**\n\n` +
+                        `**Gates:** ${g1 ?? channelStr.split("-")[0]} ↔ ${g2 ?? channelStr.split("-")[1]}\n\n` +
+                        `**Circuit:** ${info.circuit}\n\n` +
+                        `${energyDesc}\n\n` +
+                        `${info.description}`,
+                }],
+        };
+    },
+});
+const HD_CENTER_DATA = {
+    Head: {
+        keynote: "Inspiration, mental pressure, questioning",
+        biology: "Pineal gland, crown of skull",
+        circuit: "Knowing and Logic circuits",
+        defined_theme: "Consistent mental pressure to question, inspire, and seek answers. A fixed set of questions drives the mind.",
+        undefined_theme: "Amplifies others' mental pressure and questions. Wisdom comes from knowing which questions are worth answering — not every pressure needs resolution.",
+    },
+    Ajna: {
+        keynote: "Conceptualization, certainty/doubt, mental processing",
+        biology: "Pituitary/pineal gland complex, prefrontal cortex",
+        circuit: "Individual, Collective, and Tribal circuits",
+        defined_theme: "Consistent way of thinking and processing information. Opinionated and certain; thoughts have a reliable flavour.",
+        undefined_theme: "Open to many perspectives and ways of processing. The wisdom is in mental flexibility — not needing to be certain.",
+    },
+    Throat: {
+        keynote: "Communication, manifestation, action",
+        biology: "Thyroid and parathyroid glands, throat, metabolism",
+        circuit: "All circuits converge here",
+        defined_theme: "Consistent, reliable voice. Words carry predictable tone and impact. Can initiate speech and manifestation.",
+        undefined_theme: "Voice adapts to others and context. Language style shifts depending on who is around. Not designed to speak first.",
+    },
+    G: {
+        keynote: "Identity, love, direction, self",
+        biology: "Liver, blood, immune system",
+        circuit: "Individual Knowing circuit",
+        defined_theme: "Fixed sense of direction and identity. Love, magnetic attraction, and life direction are reliable and self-directed.",
+        undefined_theme: "Identity and direction shift with environment and the people around. Sensitive to place — geography matters profoundly for finding the right people.",
+    },
+    Heart: {
+        keynote: "Willpower, ego, material world, value",
+        biology: "Heart, stomach, thymus, gallbladder",
+        circuit: "Tribal circuit",
+        defined_theme: "Consistent willpower and ability to make and keep promises. Strong sense of personal value and what is worth fighting for.",
+        undefined_theme: "Willpower is not consistent — rest after exertion is essential. May prove worth unnecessarily. Nothing to prove.",
+    },
+    Sacral: {
+        keynote: "Life-force, sexuality, work, response",
+        biology: "Reproductive system, ovaries, testes",
+        circuit: "Individual, Collective, and Tribal circuits",
+        defined_theme: "Consistent, powerful life-force energy that replenishes daily. Designed to work sustainably and respond gut-first. The motor of Generators and Manifesting Generators.",
+        undefined_theme: "No consistent life-force motor. Amplifies sacral energy of defined-sacral beings when around them. Must honour when energy is done — sacral is not a reliable source.",
+    },
+    Spleen: {
+        keynote: "Intuition, instinct, fear, immune system, survival",
+        biology: "Spleen, lymphatic system, immune system, skin",
+        circuit: "Individual and Tribal circuits",
+        defined_theme: "Consistent intuition and immune awareness. Instincts are reliable; the body knows. Fear signals can be a guide rather than a trap.",
+        undefined_theme: "Splenic intuition is inconsistent — amplifies others' instincts. May hold on to things out of fear (relationships, jobs) rather than intuitive knowing.",
+    },
+    "Solar Plexus": {
+        keynote: "Emotions, feelings, desires, spirit, moods",
+        biology: "Solar plexus nerve cluster, kidneys, lungs, pancreas, prostate",
+        circuit: "Tribal and Individual circuits",
+        defined_theme: "Consistent emotional wave that cycles through highs and lows. Emotional authority: truth emerges over time, not in the moment. Waiting for clarity before deciding is essential.",
+        undefined_theme: "Amplifies and absorbs the emotional states of others. May mistake others' feelings for their own. The wisdom: emotional transparency without drama.",
+    },
+    Root: {
+        keynote: "Stress, pressure, adrenaline, momentum",
+        biology: "Adrenal glands, lower back, knees",
+        circuit: "Individual, Collective, and Tribal circuits",
+        defined_theme: "Consistent adrenal pressure that pulses rhythmically. Reliable source of drive and momentum. Healthy stress fuels accomplishment.",
+        undefined_theme: "Root pressure amplifies from others and environment. May rush to release pressure (buying things, making decisions too fast) instead of feeling it and letting it pass.",
+    },
+};
+const HD_GATE_DATA = {
+    1: { name: "The Creative", hexagram: "Hex 1 — Creative Power", keynote: "Self-expression as a creative force", gift: "Freshness — original self-expression that inspires", shadow: "Entropy — creative block from fear of not being unique", circuit: "Individual (Centering)" },
+    2: { name: "The Receptive", hexagram: "Hex 2 — Receptive Power", keynote: "The direction of the self", gift: "Orientation — knowing where to go", shadow: "Dislocation — living without inner compass", circuit: "Individual (Centering)" },
+    3: { name: "Ordering", hexagram: "Hex 3 — Difficulty at the Beginning", keynote: "Innovation from chaos", gift: "Innovation — bringing order from initial confusion", shadow: "Chaos — stuck in mutation, unable to stabilise", circuit: "Individual (Centering)" },
+    4: { name: "Formulization", hexagram: "Hex 4 — Youthful Folly", keynote: "Mental solutions that benefit humanity", gift: "Understanding — solutions that help the collective", shadow: "Incompetence — mental answers that cause harm", circuit: "Collective (Logic)" },
+    5: { name: "Fixed Rhythms", hexagram: "Hex 5 — Waiting", keynote: "Universal patterns and timing", gift: "Patience — trusting the correct timing", shadow: "Impatience — forcing outcomes", circuit: "Collective (Logic)" },
+    6: { name: "Friction", hexagram: "Hex 6 — Conflict", keynote: "The role model through experience", gift: "Diplomacy — conflict resolved through right relationship", shadow: "Conflict — isolation and withdrawal", circuit: "Collective (Logic)" },
+    7: { name: "The Role of the Self", hexagram: "Hex 7 — The Army", keynote: "Leadership in the direction of the future", gift: "Guidance — leading through personal example", shadow: "Division — leadership without authority", circuit: "Collective (Logic)" },
+    8: { name: "Contribution", hexagram: "Hex 8 — Holding Together", keynote: "Contribution to the collective through individual creativity", gift: "Style — unique contribution that inspires others", shadow: "Mediocrity — hiding unique self to fit in", circuit: "Individual (Centering)" },
+    9: { name: "Focus", hexagram: "Hex 9 — The Taming Power of the Small", keynote: "Determination and focus on detail", gift: "Determination — laser focus on what matters", shadow: "Inertia — scattered, unable to concentrate", circuit: "Collective (Logic)" },
+    10: { name: "Behaviour of the Self", hexagram: "Hex 10 — Treading", keynote: "Love of self, self-empowerment", gift: "Naturalness — authentic behaviour without self-consciousness", shadow: "Self-obsession — behaviour driven by approval-seeking", circuit: "Individual (Centering)" },
+    11: { name: "Ideas", hexagram: "Hex 11 — Peace", keynote: "The harmony of ideas", gift: "Idealism — ideas that envision greater harmony", shadow: "Obscurity — inability to ground and communicate visions", circuit: "Collective (Abstract)" },
+    12: { name: "Caution", hexagram: "Hex 12 — Standstill", keynote: "Active caution in social interaction", gift: "Discrimination — grace in social engagement", shadow: "Vanity — withdrawing emotionally from genuine connection", circuit: "Individual (Centering)" },
+    13: { name: "Fellowship of Man", hexagram: "Hex 13 — The Fellowship", keynote: "Universal listening", gift: "Empathy — the ear that holds others' stories", shadow: "Discord — secrets and betrayal", circuit: "Individual (Centering)" },
+    14: { name: "Power Skills", hexagram: "Hex 14 — Possession in Great Measure", keynote: "Accumulation of resources for collective good", gift: "Competence — using resources masterfully", shadow: "Compromise — accumulating for the wrong reasons", circuit: "Individual (Centering)" },
+    15: { name: "Extremes", hexagram: "Hex 15 — Modesty", keynote: "Extremes flow into the universal", gift: "Magnetism — extreme rhythms that attract the right others", shadow: "Dullness — inability to embrace natural extremes", circuit: "Individual (Centering)" },
+    16: { name: "Skills", hexagram: "Hex 16 — Enthusiasm", keynote: "Expressing talent with zeal", gift: "Versatility — enthusiastic expression of many skills", shadow: "Indifference — talent wasted by lack of drive", circuit: "Collective (Logic)" },
+    17: { name: "Opinions", hexagram: "Hex 17 — Following", keynote: "Opinions that help the collective move forward", gift: "Far-sightedness — opinions that serve the future", shadow: "Opinion — opinionating without wisdom", circuit: "Collective (Logic)" },
+    18: { name: "Correction", hexagram: "Hex 18 — Work on What Has Been Spoilt", keynote: "Judgment to find perfection", gift: "Integrity — correction that restores wholeness", shadow: "Judgment — criticism that wounds rather than heals", circuit: "Collective (Logic)" },
+    19: { name: "Wanting", hexagram: "Hex 19 — Approach", keynote: "Sensitivity to spirit and material needs", gift: "Sensitivity — awareness of unspoken needs", shadow: "Co-dependence — needs driving all decisions", circuit: "Tribal (Defence)" },
+    20: { name: "Contemplation", hexagram: "Hex 20 — Contemplation", keynote: "Presence in the now", gift: "Self-assurance — expressing truth in the moment", shadow: "Superficiality — words without depth", circuit: "Individual (Centering)" },
+    21: { name: "The Treasurer", hexagram: "Hex 21 — Biting Through", keynote: "Self-regulation and control in the material world", gift: "Authority — control exercised with integrity", shadow: "Control — possessiveness and domination", circuit: "Tribal (Ego)" },
+    22: { name: "Openness", hexagram: "Hex 22 — Grace", keynote: "The quality of emotional grace", gift: "Graciousness — emotional openness that transforms", shadow: "Dishonour — emotional withdrawal and defence", circuit: "Individual (Centering)" },
+    23: { name: "Splitting Apart", hexagram: "Hex 23 — Splitting Apart", keynote: "Translating the unique into language others can receive", gift: "Simplicity — the gift of making the complex clear", shadow: "Complexity — information without context or timing", circuit: "Individual (Centering)" },
+    24: { name: "Rationalisation", hexagram: "Hex 24 — Return", keynote: "The blessings of mental return and review", gift: "Invention — turning contemplation into breakthrough", shadow: "Addiction — mental looping without resolution", circuit: "Individual (Knowing)" },
+    25: { name: "Innocence", hexagram: "Hex 25 — Innocence", keynote: "The wisdom of innocence and universalising love", gift: "Acceptance — love without conditions or agenda", shadow: "Cruelty — the pain of love withheld", circuit: "Individual (Centering)" },
+    26: { name: "The Taming Power of the Great", hexagram: "Hex 26 — Taming", keynote: "Skilful transmitting of information", gift: "Artfulness — the gift of efficient, compelling communication", shadow: "Covetousness — ego-driven manipulation", circuit: "Tribal (Ego)" },
+    27: { name: "Caring", hexagram: "Hex 27 — Nourishment", keynote: "Preservation and nurturing", gift: "Altruism — sustaining others from genuine care", shadow: "Selfishness — nurturing only what benefits the self", circuit: "Tribal (Defence)" },
+    28: { name: "The Game Player", hexagram: "Hex 28 — Preponderance of the Great", keynote: "Finding purpose in struggle", gift: "Totality — fully committing to what gives life meaning", shadow: "Purposelessness — gambling with life's purpose", circuit: "Individual (Knowing)" },
+    29: { name: "The Abysmal", hexagram: "Hex 29 — The Abysmal", keynote: "Commitment and perseverance", gift: "Commitment — deep yes to what the sacral confirms", shadow: "Half-heartedness — over-committed without response", circuit: "Collective (Abstract)" },
+    30: { name: "Feelings", hexagram: "Hex 30 — The Clinging", keynote: "Recognition and feeling of experience", gift: "Lightness — riding the wave without being swept away", shadow: "Desire — driven by emotional craving", circuit: "Collective (Abstract)" },
+    31: { name: "Influence", hexagram: "Hex 31 — Influence", keynote: "Leading through democratic means", gift: "Leadership — influence through example and invitation", shadow: "Arrogance — influence through position rather than merit", circuit: "Collective (Logic)" },
+    32: { name: "Continuity", hexagram: "Hex 32 — Duration", keynote: "Intuitive assessment of what endures", gift: "Preservation — knowing what is worth preserving", shadow: "Failure — fear of failure blocking right assessment", circuit: "Tribal (Defence)" },
+    33: { name: "Privacy", hexagram: "Hex 33 — Retreat", keynote: "Knowing when to retreat and share later wisdom", gift: "Revelation — wisdom shared at the right time", shadow: "Forgetting — retreat without integration", circuit: "Collective (Abstract)" },
+    34: { name: "Power", hexagram: "Hex 34 — The Power of the Great", keynote: "Manifestation of power through response", gift: "Strength — responsive power that transforms", shadow: "Force — power without direction or response", circuit: "Individual (Centering)" },
+    35: { name: "Change", hexagram: "Hex 35 — Progress", keynote: "The hunger for experience", gift: "Adventure — embracing change for collective growth", shadow: "Hunger — chasing experience to fill an inner void", circuit: "Collective (Abstract)" },
+    36: { name: "Crisis", hexagram: "Hex 36 — Darkening of the Light", keynote: "The need for emotional experience as teacher", gift: "Humanity — finding compassion through crisis survived", shadow: "Turbulence — emotionally driven chaos and drama", circuit: "Collective (Abstract)" },
+    37: { name: "Friendship", hexagram: "Hex 37 — The Family", keynote: "Harmony through clear agreements in relationship", gift: "Equality — friendship built on mutual respect", shadow: "Inequality — bargaining and conditional love", circuit: "Tribal (Ego)" },
+    38: { name: "The Fighter", hexagram: "Hex 38 — Opposition", keynote: "Struggle in the search for purpose", gift: "Perseverance — fighting for what is meaningful", shadow: "Struggle — fighting against everything without purpose", circuit: "Individual (Knowing)" },
+    39: { name: "Provocation", hexagram: "Hex 39 — Obstruction", keynote: "Freeing the spirit through provocation", gift: "Dynamism — provocateur that liberates", shadow: "Provocation — stirring trouble unconsciously", circuit: "Individual (Knowing)" },
+    40: { name: "Aloneness", hexagram: "Hex 40 — Deliverance", keynote: "The demand for aloneness as restoration", gift: "Resolve — willpower renewed in solitude", shadow: "Exhaustion — depleted by giving without replenishment", circuit: "Tribal (Ego)" },
+    41: { name: "Contraction", hexagram: "Hex 41 — Decrease", keynote: "The beginning of all experience — fantasy and desire", gift: "Fantasy — imagination that seeds new experience", shadow: "Fantasy misused — escapism", circuit: "Collective (Abstract)" },
+    42: { name: "Growth", hexagram: "Hex 42 — Increase", keynote: "The ability to perpetuate and complete growth cycles", gift: "Detachment — completing cycles with grace", shadow: "Incompletion — abandoning cycles before they end", circuit: "Collective (Abstract)" },
+    43: { name: "Insight", hexagram: "Hex 43 — Breakthrough", keynote: "Breakthrough from within", gift: "Insight — inner knowing that arrives as genius", shadow: "Deafness — genius unrecognised or unheard", circuit: "Individual (Knowing)" },
+    44: { name: "Alertness", hexagram: "Hex 44 — Coming to Meet", keynote: "Instinctive memory and pattern recognition", gift: "Teamwork — bringing the right people together", shadow: "Interference — driven by karmic patterns from the past", circuit: "Tribal (Defence)" },
+    45: { name: "The Gatherer", hexagram: "Hex 45 — Gathering Together", keynote: "Ruling and gathering resources for the tribe", gift: "Synergy — the king/queen who gathers and empowers", shadow: "Dominance — ruling through control", circuit: "Tribal (Ego)" },
+    46: { name: "The Serendipitous", hexagram: "Hex 46 — Pushing Upward", keynote: "Love of the body and serendipity", gift: "Delight — inhabiting the body fully", shadow: "Seriousness — disconnected from physical joy", circuit: "Individual (Centering)" },
+    47: { name: "Realisation", hexagram: "Hex 47 — Oppression", keynote: "The realisation that transforms oppression", gift: "Realisation — finding the gem in difficult experience", shadow: "Oppression — trapped in mental suffering", circuit: "Collective (Abstract)" },
+    48: { name: "Well", hexagram: "Hex 48 — The Well", keynote: "The depth that provides solutions", gift: "Resourcefulness — drawing from a depth of wisdom", shadow: "Inadequacy — fear of not being deep enough", circuit: "Collective (Logic)" },
+    49: { name: "Revolution", hexagram: "Hex 49 — Revolution", keynote: "Sensitivity to right principles", gift: "Revolution — principled transformation", shadow: "Reaction — rejection driven by fear", circuit: "Tribal (Defence)" },
+    50: { name: "Values", hexagram: "Hex 50 — The Cauldron", keynote: "Values for humanity's nourishment", gift: "Responsibility — holding values that sustain the tribe", shadow: "Corruption — values compromised for survival", circuit: "Tribal (Defence)" },
+    51: { name: "The Arousing", hexagram: "Hex 51 — The Arousing", keynote: "The shock that awakens spirit", gift: "Initiative — shock as awakening force", shadow: "Agitation — disruption without purpose", circuit: "Individual (Centering)" },
+    52: { name: "Concentration", hexagram: "Hex 52 — Keeping Still", keynote: "Concentration and stillness as a power", gift: "Restraint — focused stillness that creates mastery", shadow: "Stress — adrenal pressure without direction", circuit: "Collective (Logic)" },
+    53: { name: "Beginnings", hexagram: "Hex 53 — Development", keynote: "Pressure to start new cycles", gift: "Expansion — initiating growth cycles", shadow: "Immaturity — starting without completing", circuit: "Collective (Abstract)" },
+    54: { name: "Ambition", hexagram: "Hex 54 — The Marrying Maiden", keynote: "The transformative fuel of ambition", gift: "Aspiration — ambition that elevates all", shadow: "Greed — reaching for position at others' expense", circuit: "Tribal (Defence)" },
+    55: { name: "Abundance", hexagram: "Hex 55 — Abundance", keynote: "Emotional abundance and spirit", gift: "Freedom — emotional richness surrendered to spirit", shadow: "Victimisation — emotional suffering without spirit", circuit: "Individual (Knowing)" },
+    56: { name: "Stimulation", hexagram: "Hex 56 — The Wanderer", keynote: "Stimulating stories and beliefs", gift: "Enrichment — stories that expand perspective", shadow: "Distraction — stories that mislead", circuit: "Collective (Abstract)" },
+    57: { name: "Intuitive Insight", hexagram: "Hex 57 — The Gentle", keynote: "Intuitive insight in the now", gift: "Clarity — penetrating intuition that clears confusion", shadow: "Unease — anxiety from ignoring the body's signals", circuit: "Individual (Knowing)" },
+    58: { name: "Vitality", hexagram: "Hex 58 — The Joyous", keynote: "Vitality and the joy of life", gift: "Vitality — life-force expressed as joy", shadow: "Dissatisfaction — criticism of what is imperfect", circuit: "Collective (Logic)" },
+    59: { name: "Sexuality", hexagram: "Hex 59 — Dispersion", keynote: "Intimacy and aura penetration", gift: "Intimacy — dissolving the aura safely into union", shadow: "Dishonesty — seduction without regard for truth", circuit: "Tribal (Defence)" },
+    60: { name: "Acceptance", hexagram: "Hex 60 — Limitation", keynote: "Acceptance of limitation as the basis for transcendence", gift: "Realism — working within constraints creatively", shadow: "Conservatism — clinging to limitation as identity", circuit: "Individual (Knowing)" },
+    61: { name: "Mystery", hexagram: "Hex 61 — Inner Truth", keynote: "The pressure to understand the unknowable", gift: "Inspiration — inner knowing beyond logic", shadow: "Psychosis — consumed by the search for unknowable truths", circuit: "Individual (Knowing)" },
+    62: { name: "Detail", hexagram: "Hex 62 — Preponderance of the Small", keynote: "The precision of detail and naming", gift: "Precision — detail that serves communication", shadow: "Intellectualism — detail without substance", circuit: "Collective (Logic)" },
+    63: { name: "Doubt", hexagram: "Hex 63 — After Completion", keynote: "Logical doubt as a mental pressure", gift: "Inquiry — questioning that leads to new solutions", shadow: "Doubt — anxiety about an unknowable future", circuit: "Collective (Logic)" },
+    64: { name: "Confusion", hexagram: "Hex 64 — Before Completion", keynote: "The inspiration pressure before clarity", gift: "Imagination — holding confusion long enough for illumination", shadow: "Confusion — overwhelmed by unresolved mental images", circuit: "Collective (Abstract)" },
+};
+const HD_CHANNEL_DATA = {
+    "1-8": { name: "Inspiration", circuit: "Individual (Centering)", energy_type: "projected", description: "The channel of creative inspiration — a unique individual frequency that inspires others through authentic self-expression. Not designed to broadcast; waits for recognition." },
+    "2-14": { name: "The Beat", circuit: "Individual (Centering)", energy_type: "generated", description: "The channel of the keeper of keys — a powerful sacral motor connected to the G center's direction. Attracts others magnetically toward purposeful resource accumulation." },
+    "3-60": { name: "Mutation", circuit: "Individual (Knowing)", energy_type: "generated", description: "The channel of mutation — energy that transforms through accepted limitation. Initiates new patterns in a discontinuous, pulse-like fashion that disrupts the old." },
+    "4-63": { name: "Logic", circuit: "Collective (Logic)", energy_type: "projected", description: "The channel of mental logic — pressure and solutions meeting in a cycle of questioning and formulizing. Mental energy that must wait to be asked before offering answers." },
+    "5-15": { name: "Rhythm", circuit: "Collective (Logic)", energy_type: "generated", description: "The channel of fixed rhythms — humanity's flow and fixed patterns. Sacral motor powering universal timing; key to humanity's biological health rhythms." },
+    "6-59": { name: "Intimacy", circuit: "Tribal (Defence)", energy_type: "generated", description: "The channel of intimacy — penetrating auras for mating and reproduction. Emotional authority governing who is let past one's auric boundaries." },
+    "7-31": { name: "The Alpha", circuit: "Collective (Logic)", energy_type: "projected", description: "The channel of the leader — democratic leadership providing direction to the collective. Recognition and invitation are essential; leadership must be elected, not seized." },
+    "9-52": { name: "Concentration", circuit: "Collective (Logic)", energy_type: "generated", description: "The channel of the focused mind — detail and concentration driving sacral response. Sustains attention on a single thread of logic until it resolves." },
+    "10-20": { name: "Awakening", circuit: "Individual (Centering)", energy_type: "projected", description: "The channel of awakening — the behaviour of the self expressed in the now. Presence and authenticity expressed without self-consciousness; a love of life in motion." },
+    "10-34": { name: "Exploration", circuit: "Individual (Centering)", energy_type: "generated", description: "The channel of following one's convictions — sacral power directed toward authentic self-expression and exploration. Highly independent." },
+    "10-57": { name: "Perfected Form", circuit: "Individual (Centering)", energy_type: "projected", description: "The channel of perfected form — survival instinct guided by intuition. Body awareness at its most refined; may produce physical beauty or extraordinary physical gifts." },
+    "11-56": { name: "Curiosity", circuit: "Collective (Abstract)", energy_type: "projected", description: "The channel of the storyteller — abstract ideas turned into stimulating stories that expand others' perspectives. Conceptual awareness awaiting recognition." },
+    "12-22": { name: "Openness", circuit: "Individual (Centering)", energy_type: "projected", description: "The channel of openness — emotional grace in social engagement. When the wave is right, this channel opens conversations that can transform others profoundly." },
+    "13-33": { name: "The Prodigal", circuit: "Collective (Abstract)", energy_type: "projected", description: "The channel of witness — listening to humanity's stories and retreating to share crystallised wisdom at the right time. The therapist channel." },
+    "16-48": { name: "The Wavelength", circuit: "Collective (Logic)", energy_type: "projected", description: "The channel of talent — depth of skill expressed as enthusiasm. Natural mastery that appears effortless; awakens when talents are recognised and invited." },
+    "17-62": { name: "Acceptance", circuit: "Collective (Logic)", energy_type: "projected", description: "The channel of organised activity — opinions formulated into detailed plans and frameworks. Facts and logic turned into workable systems." },
+    "18-58": { name: "Judgement", circuit: "Collective (Logic)", energy_type: "projected", description: "The channel of judgement — passionate criticism in service of joy and vitality. The desire to perfect what is alive; driven by love of life." },
+    "19-49": { name: "Synthesis", circuit: "Tribal (Defence)", energy_type: "projected", description: "The channel of synthesis — sensitivity to the tribe's emotional and material needs, combined with the power to revolutionise through principle. Resources and revolution." },
+    "20-34": { name: "Charisma", circuit: "Individual (Centering)", energy_type: "generated", description: "The channel of charisma — sacral response expressed in the now with extraordinary presence. Manifesting Generators often carry this channel; built for busy, impactful lives." },
+    "20-57": { name: "The Brain Wave", circuit: "Individual (Centering)", energy_type: "projected", description: "The channel of the brain wave — penetrating intuitive insight expressed without hesitation. A frequency that can inform the now with body-level knowing." },
+    "21-45": { name: "Money Line", circuit: "Tribal (Ego)", energy_type: "projected", description: "The channel of the money line — material world governance. Control over resources in the tribal hierarchy; the king/queen and the treasurer aligned." },
+    "23-43": { name: "Structuring", circuit: "Individual (Knowing)", energy_type: "projected", description: "The channel of structuring — translating individual genius into language that others can hear. The key is timing; genius shared before recognition falls on deaf ears." },
+    "24-61": { name: "Awareness", circuit: "Individual (Knowing)", energy_type: "projected", description: "The channel of awareness — mental pressure toward inner truth. Contemplative awareness cycling through questions until a genuine breakthrough arrives." },
+    "25-51": { name: "Initiation", circuit: "Individual (Centering)", energy_type: "projected", description: "The channel of initiation — innocence meeting the shock of the new. The shamanic channel; moves through crisis into universalising love." },
+    "26-44": { name: "Surrender", circuit: "Tribal (Defence)", energy_type: "projected", description: "The channel of surrender — ego memory and the transmission of the tribe's past patterns. Alert to what has and has not worked; a natural business channel." },
+    "27-50": { name: "Preservation", circuit: "Tribal (Defence)", energy_type: "generated", description: "The channel of preservation — nurturing and values sustaining the tribe across generations. The channel of the mother/father archetype; keeping what is valuable alive." },
+    "28-38": { name: "Struggle", circuit: "Individual (Knowing)", energy_type: "generated", description: "The channel of struggle — the game player meets the fighter in a search for purpose. Life is the game; the question is what is worth the fight." },
+    "29-46": { name: "Discovery", circuit: "Collective (Abstract)", energy_type: "generated", description: "The channel of discovery — sacral commitment to embodied experience. The body as the vehicle for serendipitous encounter; the great 'yes' to life." },
+    "30-41": { name: "Recognition", circuit: "Collective (Abstract)", energy_type: "projected", description: "The channel of recognition — the beginning of all human experience. Emotional desire and fantasy that ignites new experiential cycles." },
+    "32-54": { name: "Transformation", circuit: "Tribal (Defence)", energy_type: "generated", description: "The channel of transformation — instinct to transform ambition into material continuity. What endures; which ambitions serve the tribe's long-term survival." },
+    "34-57": { name: "Power", circuit: "Individual (Centering)", energy_type: "generated", description: "The channel of power — sacral life-force guided by intuition. Raw responsive power with in-the-moment instinctive awareness; self-sufficient and magnetic." },
+    "35-36": { name: "Transitoriness", circuit: "Collective (Abstract)", energy_type: "projected", description: "The channel of transitoriness — the hunger for experience and the emotional crisis of each encounter. Rich emotional lessons through fully-felt experience." },
+    "37-40": { name: "Community", circuit: "Tribal (Ego)", energy_type: "projected", description: "The channel of community — bargain and agreement sustaining the family/tribe. Willpower renewed through rest; clear deals that make community sustainable." },
+    "39-55": { name: "Emoting", circuit: "Individual (Knowing)", energy_type: "projected", description: "The channel of emoting — the provocateur meeting the spirit of abundance. Gate 39 stirs the emotional wave; gate 55 determines whether spirit or suffering answers." },
+    "42-53": { name: "Maturation", circuit: "Collective (Abstract)", energy_type: "generated", description: "The channel of maturation — beginning and completing cycles of growth. The channel of sustainability; sacral energy that completes what it starts." },
+    "47-64": { name: "Abstraction", circuit: "Collective (Abstract)", energy_type: "projected", description: "The channel of abstraction — confusion ripening into realisation. Mental pressure from the past meeting images from the future; the alchemy of wisdom." },
+    "57-20": { name: "The Brain Wave", circuit: "Individual (Centering)", energy_type: "projected", description: "The channel of the brain wave — penetrating intuitive insight expressed without hesitation. A frequency that can inform the now with body-level knowing." },
+    "58-18": { name: "Judgement", circuit: "Collective (Logic)", energy_type: "projected", description: "The channel of judgement — vitality and correction. Joy arising from the pursuit of perfection in what is living and alive." },
+    "59-6": { name: "Intimacy", circuit: "Tribal (Defence)", energy_type: "generated", description: "The channel of intimacy — penetrating auras for mating and reproduction. Emotional authority governing who is let past one's auric boundaries." },
+    "60-3": { name: "Mutation", circuit: "Individual (Knowing)", energy_type: "generated", description: "The channel of mutation — energy that transforms through accepted limitation. Initiates new patterns in a discontinuous, pulse-like fashion." },
+};