@openephemeris/mcp-server 3.14.0 → 3.15.0

package/dist/tools/dev.js

@@ -32,66 +32,72 @@ function isDeniedByPrefix(pathname, prefixes) {
 function isAllowedOperation(method, pathname, allow) {
     return allow.some((e) => e.method === method && e.path === pathname);
 }
-registerTool({
-    name: "dev_call",
-    description: "Call any allowlisted Open Ephemeris API endpoint directly. This is the power-user escape hatch " +
-        "— use the typed tools (ephemeris_natal_chart, ephemeris_transits, etc.) first for common operations. " +
-        "Call dev_list_allowed to see all currently available endpoint paths.\n\n" +
-        "AUTH: Set OPENEPHEMERIS_API_KEY in your environment. See openephemeris.com/dashboard for active plan limits.\n\n" +
-        "CREDIT COSTS:\n" +
-        "  • Standard chart math (natal, progressed, bazi, vedic, iching): 1 credit\n" +
-        "  • Human Design: 2 credits\n" +
-        "  • Visualization rendering (chart-wheel, bi-wheel, charts/*): 2 credits\n" +
-        "  • Comparative math (synastry, composite, overlay): 3 credits\n" +
-        "  • Predictive ops (transits/search, returns): 5 credits\n" +
-        "  • Predictive transit-chart: 1 credit\n" +
-        "  • ACG / astrocartography: 10 credits (acg/hits: 15 credits)\n" +
-        "  • Calendar endpoints: 10 credits\n" +
-        "  • Catalog / metadata / health endpoints: 0 credits\n" +
-        "  • Compute surcharge: requests > 30s add 1 credit per 30s (predictive, acg, calendar, electional)\n" +
-        "  • format=llm (token-optimized output): available on all tiers\n\n" +
-        "COMMON CALLS:\n" +
-        "  POST /ephemeris/natal-chart            — Full natal chart (body: {subject: {name: 'Name', birth_datetime: {iso: '1990-04-15T14:30:00-05:00'}, birth_location: {latitude: {decimal: 40.0}, longitude: {decimal: -70.0}, timezone: {}}}})\n" +
-        "  POST /ephemeris/natal/batch            — Up to 50 natal charts in one request\n" +
-        "  POST /ephemeris/relocation             — Relocated chart (same natal, new location)\n" +
-        "  POST /predictive/transits/search       — Transit event search over a date range\n" +
-        "  POST /predictive/returns/solar         — Solar return chart\n" +
-        "  POST /predictive/returns/lunar         — Lunar return chart\n" +
-        "  POST /comparative/synastry             — Two-person synastry chart\n" +
-        "  POST /comparative/composite            — Composite (midpoint) chart\n" +
-        "  POST /human-design/chart               — Full HD chart (body: {birth_datetime_utc: '1990-04-15T19:30:00Z'}) — lat/lon optional\n" +
-        "  POST /time/julian-day                  — Convert date to JD (body: {year: 1987, month: 7, day: 15, hour: 14, minute: 1})\n" +
-        "  GET  /ephemeris/moon/phase             — Current/queried moon phase\n" +
-        "  GET  /ephemeris/moon/void-of-course    — Next void-of-course period\n" +
-        "  GET  /ephemeris/agro/daily             — Biodynamic farming day quality\n" +
-        "  GET  /ephemeris/agro/calendar          — Multi-day biodynamic calendar\n" +
-        "  GET  /ephemeris/agro/void-of-course    — Biodynamic VoC periods\n" +
-        "  GET  /eclipse/next-visible             — Next eclipse visible from a location (query: lat, lon, type=solar|lunar)\n" +
-        "  GET  /eclipse/solar/global             — Next global solar eclipse (query: date=YYYY-MM-DD)\n" +
-        "  GET  /eclipse/solar/local              — Local solar eclipse (query: lat, lon)\n" +
-        "  GET  /tidal/forcing                    — Gravitational tidal forcing index\n" +
-        "  POST /acg/power-lines                 — Astrocartography power lines (lat/lon GeoJSON)\n" +
-        "  POST /acg/hits                         — ACG power at a specific location\n" +
-        "  GET  /calendar/astrology/moon-phases   — Moon phase calendar for a date range\n" +
-        "  GET  /location/autocomplete            — Geocode a place name (query: q=City Name)\n" +
-        "  POST /timezone/lookup                  — Resolve timezone + UTC offset for a location\n" +
-        "  POST /chinese/bazi                     — Chinese Ba Zi (Four Pillars) chart (body: {year, month, day, hour})\n" +
-        "  GET  /chinese/zodiac                   — Chinese zodiac year element/animal\n" +
-        "  POST /vedic/chart                      — Vedic (Jyotish) natal chart (body: {datetime_utc, latitude, longitude})\n" +
-        "  GET  /catalogs/bodies                  — List all supported celestial bodies\n\n" +
-        "BINARY RESPONSES:\n" +
-        "  • Binary/image endpoints return {content_type, content_length, encoding, data_base64}\n" +
-        "    so callers can decode bytes deterministically.\n\n" +
-        "ECLIPSE NOTE: Eclipse endpoints accept format=llm via the query param like other endpoints.\n\n" +
-        "format=llm NOTE: Add query: {format: 'llm'} to natal/synastry/composite/HD endpoints for " +
-        "compact columnar output optimized for LLM token budgets (availability depends on your current plan).",
-    inputSchema: {
+// Shared reference block appended to both read/write proxy tools. Names the
+// target API (Open Ephemeris) explicitly — required by the directory for
+// freeform-path tools — plus credit costs and common calls.
+const DEV_API_REFERENCE = "Target API: Open Ephemeris REST API (https://api.openephemeris.com). " +
+    "Call dev_list_allowed to see all currently available endpoint paths.\n\n" +
+    "AUTH: Set OPENEPHEMERIS_API_KEY in your environment. See openephemeris.com/dashboard for active plan limits.\n\n" +
+    "CREDIT COSTS:\n" +
+    "  • Standard chart math (natal, progressed, bazi, vedic, iching): 1 credit\n" +
+    "  • Human Design: 2 credits\n" +
+    "  • Visualization rendering (chart-wheel, bi-wheel, charts/*): 2 credits\n" +
+    "  • Comparative math (synastry, composite, overlay): 3 credits\n" +
+    "  • Predictive ops (transits/search, returns): 5 credits\n" +
+    "  • Predictive transit-chart: 1 credit\n" +
+    "  • ACG / astrocartography: 10 credits (acg/hits: 15 credits)\n" +
+    "  • Calendar endpoints: 10 credits\n" +
+    "  • Catalog / metadata / health endpoints: 0 credits\n" +
+    "  • Compute surcharge: requests > 30s add 1 credit per 30s (predictive, acg, calendar, electional)\n" +
+    "  • format=llm (token-optimized output): available on all tiers\n\n" +
+    "COMMON CALLS:\n" +
+    "  POST /ephemeris/natal-chart            — Full natal chart (body: {subject: {name: 'Name', birth_datetime: {iso: '1990-04-15T14:30:00-05:00'}, birth_location: {latitude: {decimal: 40.0}, longitude: {decimal: -70.0}, timezone: {}}}})\n" +
+    "  POST /ephemeris/natal/batch            — Up to 50 natal charts in one request\n" +
+    "  POST /ephemeris/relocation             — Relocated chart (same natal, new location)\n" +
+    "  POST /predictive/transits/search       — Transit event search over a date range\n" +
+    "  POST /predictive/returns/solar         — Solar return chart\n" +
+    "  POST /predictive/returns/lunar         — Lunar return chart\n" +
+    "  POST /comparative/synastry             — Two-person synastry chart\n" +
+    "  POST /comparative/composite            — Composite (midpoint) chart\n" +
+    "  POST /human-design/chart               — Full HD chart (body: {birth_datetime_utc: '1990-04-15T19:30:00Z'}) — lat/lon optional\n" +
+    "  POST /time/julian-day                  — Convert date to JD (body: {year: 1987, month: 7, day: 15, hour: 14, minute: 1})\n" +
+    "  GET  /ephemeris/moon/phase             — Current/queried moon phase\n" +
+    "  GET  /ephemeris/moon/void-of-course    — Next void-of-course period\n" +
+    "  GET  /ephemeris/agro/daily             — Biodynamic farming day quality\n" +
+    "  GET  /ephemeris/agro/calendar          — Multi-day biodynamic calendar\n" +
+    "  GET  /ephemeris/agro/void-of-course    — Biodynamic VoC periods\n" +
+    "  GET  /eclipse/next-visible             — Next eclipse visible from a location (query: lat, lon, type=solar|lunar)\n" +
+    "  GET  /eclipse/solar/global             — Next global solar eclipse (query: date=YYYY-MM-DD)\n" +
+    "  GET  /eclipse/solar/local              — Local solar eclipse (query: lat, lon)\n" +
+    "  GET  /tidal/forcing                    — Gravitational tidal forcing index\n" +
+    "  POST /acg/power-lines                 — Astrocartography power lines (lat/lon GeoJSON)\n" +
+    "  POST /acg/hits                         — ACG power at a specific location\n" +
+    "  GET  /calendar/astrology/moon-phases   — Moon phase calendar for a date range\n" +
+    "  GET  /location/autocomplete            — Geocode a place name (query: q=City Name)\n" +
+    "  POST /timezone/lookup                  — Resolve timezone + UTC offset for a location\n" +
+    "  POST /chinese/bazi                     — Chinese Ba Zi (Four Pillars) chart (body: {year, month, day, hour})\n" +
+    "  GET  /chinese/zodiac                   — Chinese zodiac year element/animal\n" +
+    "  POST /vedic/chart                      — Vedic (Jyotish) natal chart (body: {datetime_utc, latitude, longitude})\n" +
+    "  GET  /catalogs/bodies                  — List all supported celestial bodies\n\n" +
+    "BINARY RESPONSES:\n" +
+    "  • Binary/image endpoints return {content_type, content_length, encoding, data_base64}\n" +
+    "    so callers can decode bytes deterministically.\n\n" +
+    "ECLIPSE NOTE: Eclipse endpoints accept format=llm via the query param like other endpoints.\n\n" +
+    "format=llm NOTE: Add query: {format: 'llm'} to natal/synastry/composite/HD endpoints for " +
+    "compact columnar output optimized for LLM token budgets (availability depends on your current plan).";
+// The read and write proxies are kept as separate tools (not one method-switching
+// tool) so that safe GET reads never share a surface with state-changing writes —
+// a hard requirement of the Anthropic connector directory.
+const READ_METHODS = ["GET"];
+const WRITE_METHODS = ["POST", "PUT", "PATCH", "DELETE"];
+function makeProxyInputSchema(methods) {
+    return {
         type: "object",
         properties: {
             method: {
                 type: "string",
-                enum: ["GET", "POST", "PUT", "PATCH", "DELETE"],
-                description: "HTTP method",
+                enum: methods,
+                description: methods.length === 1 ? `HTTP method (always ${methods[0]})` : "HTTP method",
             },
             path: {
                 type: "string",
@@ -100,10 +106,10 @@ registerTool({
             query: {
                 type: "object",
                 additionalProperties: true,
-                description: "Query params for GET requests (optional)",
+                description: "Query params (optional)",
             },
             body: {
-                description: "JSON body for POST/PUT/PATCH (optional)",
+                description: "JSON request body (optional)",
             },
             preset: {
                 type: "string",
@@ -121,15 +127,16 @@ registerTool({
                 description: "Legacy convenience (deprecated): if provided, set query.output_mode and also map to query.preset/query.format when possible.",
             },
         },
-        required: ["method", "path"],
+        required: ["path"],
         additionalProperties: false,
-    },
-    outputSchema: OUTPUT_SCHEMA_JSON,
-    handler: async (args) => {
+    };
+}
+function makeProxyHandler(allowedMethods, defaultMethod) {
+    return async (args) => {
         validateRequired(args, ["path"]);
-        const methodStr = String(args.method || "GET").toUpperCase();
-        if (!["GET", "POST", "PUT", "PATCH", "DELETE"].includes(methodStr)) {
-            throw new Error(`Invalid HTTP method: ${methodStr}`);
+        const methodStr = String(args.method || defaultMethod).toUpperCase();
+        if (!allowedMethods.includes(methodStr)) {
+            throw new Error(`Method ${methodStr} not permitted by this tool. Allowed: ${allowedMethods.join(", ")}.`);
         }
         const method = methodStr;
         const pathname = String(args.path);
@@ -177,21 +184,48 @@ registerTool({
             params: query,
             data: body,
         });
-    },
+    };
+}
+registerTool({
+    name: "dev_read_api",
+    description: "Read from any allowlisted Open Ephemeris API endpoint via HTTP GET. This is the read-only " +
+        "power-user escape hatch — use the typed tools (ephemeris_natal_chart, ephemeris_transits, etc.) " +
+        "first for common operations. For endpoints that compute via POST (natal-chart, synastry, etc.), " +
+        "use dev_write_api.\n\n" +
+        DEV_API_REFERENCE,
+    inputSchema: makeProxyInputSchema(READ_METHODS),
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    // GET-only: never mutates server state.
+    annotations: { title: "API Read", readOnlyHint: true, openWorldHint: true },
+    handler: makeProxyHandler(READ_METHODS, "GET"),
+});
+registerTool({
+    name: "dev_write_api",
+    description: "Send a request to any allowlisted Open Ephemeris API endpoint via POST/PUT/PATCH/DELETE. " +
+        "Most chart computations (natal-chart, synastry, composite, transits/search, returns, ACG) are " +
+        "POST endpoints and use this tool. Use the typed tools first for common operations; use dev_read_api " +
+        "for GET endpoints.\n\n" +
+        DEV_API_REFERENCE,
+    inputSchema: makeProxyInputSchema(WRITE_METHODS),
+    outputSchema: OUTPUT_SCHEMA_JSON,
+    // Issues POST/PUT/PATCH/DELETE — must not be advertised as read-only.
+    annotations: { title: "API Write", readOnlyHint: false, openWorldHint: true },
+    handler: makeProxyHandler(WRITE_METHODS, "POST"),
 });
 registerTool({
     name: "dev_list_allowed",
     description: "List all API operations (method + path) that this MCP instance is authorized to call. " +
         "Returns endpoint entries grouped by method, plus the active deny rules. " +
-        "Use this to discover what's available before calling dev_call, or to verify an endpoint path. " +
+        "Use this to discover what's available before calling dev_read_api / dev_write_api, or to verify an endpoint path. " +
         "Typed shortcut tools (ephemeris_natal_chart, ephemeris_transits, etc.) cover the most common operations — " +
-        "check those first before reaching for dev_call.",
+        "check those first before reaching for the generic proxies.",
     inputSchema: {
         type: "object",
         properties: {},
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
+    annotations: { title: "List Allowed API Operations", readOnlyHint: true, openWorldHint: false },
     handler: async () => {
         const allowlist = loadAllowlist();
         return {

package/dist/tools/index.d.ts

@@ -52,6 +52,16 @@ export declare function initTools(profile?: ToolProfile): Promise<void>;
  * Throws an error if any of the required keys are missing or empty.
  */
 export declare function validateRequired(args: any, requiredKeys: string[]): void;
+/**
+ * Returns `value` only if it is one of `allowed`, otherwise `undefined`.
+ *
+ * Use for any tool argument that gets interpolated into a backend URL/query
+ * string. Even though the inputSchema declares an `enum`, the MCP host does
+ * not guarantee enum enforcement, so a hostile client could smuggle extra
+ * query parameters (e.g. style="dark&admin=1"). Whitelisting here closes that
+ * injection vector at the boundary (DATA-6).
+ */
+export declare function pickEnum<T extends string>(value: unknown, allowed: readonly T[]): T | undefined;
 /**
  * Throws an error if only one of the coordinate pair is provided.
  */

package/dist/tools/index.js

@@ -44,7 +44,7 @@ export async function initTools(profile) {
     const resolvedProfile = (profile || process.env.OPENEPHEMERIS_PROFILE || process.env.ASTROMCP_PROFILE || "dev").toLowerCase();
     // Always register auth tools (available in all profiles).
     await import("./auth.js");
-    // Always register the generic proxy tools (dev.call + dev.list_allowed).
+    // Always register the generic proxy tools (dev_read_api + dev_write_api + dev_list_allowed).
     await import("./dev.js");
     if (resolvedProfile === "dev") {
         // ── FULL BUILD: all specialized tools ───────────────────────────
@@ -93,6 +93,20 @@ export function validateRequired(args, requiredKeys) {
         throw new Error(`Missing required arguments: ${missing.join(", ")}`);
     }
 }
+/**
+ * Returns `value` only if it is one of `allowed`, otherwise `undefined`.
+ *
+ * Use for any tool argument that gets interpolated into a backend URL/query
+ * string. Even though the inputSchema declares an `enum`, the MCP host does
+ * not guarantee enum enforcement, so a hostile client could smuggle extra
+ * query parameters (e.g. style="dark&admin=1"). Whitelisting here closes that
+ * injection vector at the boundary (DATA-6).
+ */
+export function pickEnum(value, allowed) {
+    return typeof value === "string" && allowed.includes(value)
+        ? value
+        : undefined;
+}
 /**
  * Throws an error if only one of the coordinate pair is provided.
  */

package/dist/tools/specialized/bazi.js

@@ -145,7 +145,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Day Master Analysis", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Ten Gods", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const body = { ...parseBaziArgs(args) };
         applyVisualConfig(body, args);
@@ -180,7 +180,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Clash & Combination", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Element Balance", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const body = { ...parseBaziArgs(args) };
         applyVisualConfig(body, args);
@@ -223,7 +223,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Ten Gods", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Luck Pillars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         if (!args.gender) {
             throw new Error("gender is required for luck pillar calculation. " +
@@ -266,7 +266,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Luck Pillars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Annual Pillar", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         if (!args.year) {
             throw new Error("year is required. Provide a Gregorian year (1–9999), e.g. year=2025.");
@@ -321,7 +321,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Annual Pillars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Compatibility", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const chartAComponents = parseBaziArgs({
             year: args.chart_a_year,
@@ -381,7 +381,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Compatibility", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Chart (Visual)", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         const { year, month, day, hour } = parseBaziArgs(args);
         const body = {

package/dist/tools/specialized/bi_wheel.js

@@ -1,4 +1,4 @@
-import { registerTool, validateRequired } from "../index.js";
+import { registerTool, validateRequired, pickEnum } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_IMAGE } from "../output-schemas.js";
 const DATETIME_DESC = "ISO 8601 datetime string, e.g. '1990-04-15T14:30:00' (local time at birth location). " +
@@ -71,7 +71,8 @@ registerTool({
             const mappedCode = HOUSE_SYSTEM_MAP[args.house_system] || "P";
             body.configuration = { house_system: mappedCode };
         }
-        const styleParam = args.style ? `&style=${args.style}` : "";
+        const style = pickEnum(args.style, ["light", "dark", "mono"]);
+        const styleParam = style ? `&style=${style}` : "";
         return await getActiveClient().post(`/visualization/bi-wheel?format=svg&size=800${styleParam}`, body);
     },
 });

package/dist/tools/specialized/chart_wheel.js

@@ -1,4 +1,4 @@
-import { registerTool, validateRequired } from "../index.js";
+import { registerTool, validateRequired, pickEnum } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_IMAGE } from "../output-schemas.js";
 const DATETIME_DESC = "ISO 8601 datetime string, e.g. '1990-04-15T14:30:00' (local time at birth location). " +
@@ -68,7 +68,8 @@ registerTool({
             const mappedCode = HOUSE_SYSTEM_MAP[args.house_system] || "P";
             body.configuration = { house_system: mappedCode };
         }
-        const styleParam = args.style ? `&style=${args.style}` : "";
+        const style = pickEnum(args.style, ["light", "dark", "mono"]);
+        const styleParam = style ? `&style=${style}` : "";
         return await getActiveClient().post(`/visualization/chart-wheel?format=svg&size=800${styleParam}`, body);
     },
 });

package/dist/tools/specialized/comparative.js

@@ -136,7 +136,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Planet Compatibility Score", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Synastry House Overlay", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -179,7 +179,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Composite Chart Aspects", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Transits to Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude"]);
         // Backend expects: { subject: {...}, transit_datetime?: {...} }

package/dist/tools/specialized/hd_bodygraph.js

@@ -1,4 +1,4 @@
-import { registerTool, validateRequired } from "../index.js";
+import { registerTool, validateRequired, pickEnum } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 /** Append 'Z' if no timezone offset is present in the datetime string. */
@@ -47,8 +47,9 @@ registerTool({
         const body = {
             birth_datetime_utc: ensureTimezone(args.datetime),
         };
-        const format = args.format || "svg";
-        const styleParam = args.style ? `&style=${args.style}` : "";
+        const format = pickEnum(args.format, ["svg", "png"]) || "svg";
+        const style = pickEnum(args.style, ["light", "dark", "mono"]);
+        const styleParam = style ? `&style=${style}` : "";
         return await getActiveClient().post(`/visualization/bodygraph?format=${format}&size=800${styleParam}`, body);
     },
 });

package/dist/ui/bazi.html

@@ -1,26 +1,26 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <meta name="color-scheme" content="dark light" />
-  <title>BaZi Four Pillars Explorer</title>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <meta name="color-scheme" content="dark light" />
+  <title>BaZi Four Pillars Explorer</title>
   
   
 <style>*,:before,:after{box-sizing:border-box;margin:0;padding:0}:root{--bg-primary:#090b0f;--bg-secondary:#12161d;--bg-tertiary:#1c222b;--bg-hover:#272e3b;--border:#282e38;--border-subtle:#1d2229;--text-primary:#e1e5eb;--text-secondary:#9da5b1;--text-muted:#6c727b;--accent:#62b3ff;--accent-warm:#e6ac3d;--radius:8px;--radius-sm:4px;--radius-lg:12px;--wuxing-wood:#31aa40;--wuxing-fire:#f14d4c;--wuxing-earth:#ca8a10;--wuxing-metal:#9fafc8;--wuxing-water:#0099e0;--wuxing-wood-bg:#1b451e;--wuxing-fire-bg:#65201e;--wuxing-earth-bg:#583c10;--wuxing-metal-bg:#3c434d;--wuxing-water-bg:#003f60;--dm-border:#d29922;--dm-bg:#201a10;--lightningcss-light: ;--lightningcss-dark:initial;color-scheme:dark}@supports (color:color(display-p3 0 0 0)){:root{--bg-primary:color(display-p3 .036047 .0438664 .059078);--bg-secondary:color(display-p3 .0739679 .0866504 .111186);--bg-tertiary:color(display-p3 .114361 .13221 .166818);--bg-hover:color(display-p3 .15679 .180114 .225406);--border:color(display-p3 .161376 .180145 .216325);--border-subtle:color(display-p3 .118728 .13221 .158123);--text-primary:color(display-p3 .883958 .896627 .920543);--text-secondary:color(display-p3 .622745 .646433 .6914);--text-muted:color(display-p3 .429297 .445909 .477439);--accent:color(display-p3 .446063 .694439 1.01077);--accent-warm:color(display-p3 .866978 .684443 .324483);--wuxing-wood:color(display-p3 .343741 .657851 .307102);--wuxing-fire:color(display-p3 .872583 .352089 .325751);--wuxing-earth:color(display-p3 .754604 .550516 .200367);--wuxing-metal:color(display-p3 .636614 .68404 .77495);--wuxing-water:color(display-p3 .226818 .589506 .875825);--wuxing-wood-bg:color(display-p3 .150499 .267148 .135899);--wuxing-fire-bg:color(display-p3 .36387 .143128 .129405);--wuxing-earth-bg:color(display-p3 .328547 .240912 .0972974);--wuxing-metal-bg:color(display-p3 .240898 .260909 .299258);--wuxing-water-bg:color(display-p3 .0921333 .242221 .364185);--dm-border:color(display-p3 .789908 .60997 .245434);--dm-bg:color(display-p3 .119765 .101379 .0671137)}}@supports (color:lab(0% 0 0)){:root{--bg-primary:lab(3.02674% -.179462 -2.15476);--bg-secondary:lab(7.16596% -.441141 -5.41423);--bg-tertiary:lab(12.9118% -.60384 -7.27841);--bg-hover:lab(18.6882% -.727877 -9.08878);--border:lab(18.7165% -.689313 -7.30941);--border-subtle:lab(12.9391% -.548743 -5.49436);--text-primary:lab(90.6878% -.517368 -3.73452);--text-secondary:lab(67.45% -.932217 -7.41489);--text-muted:lab(47.7476% -.701487 -5.56231);--accent:lab(70.4043% -7.21234 -50.7672);--accent-warm:lab(74.5248% 14.3487 62.5064);--wuxing-wood:lab(61.5358% -50.6384 43.17);--wuxing-fire:lab(57.3944% 63.124 38.0626);--wuxing-earth:lab(62.7263% 19.0613 64.9727);--wuxing-metal:lab(70.8424% -1.5474 -14.6858);--wuxing-water:lab(59.1191% -14.8305 -49.6808);--wuxing-wood-bg:lab(25.5679% -22.4482 18.6532);--wuxing-fire-bg:lab(23.6033% 31.5073 18.7032);--wuxing-earth-bg:lab(28.0231% 9.19801 30.8603);--wuxing-metal-bg:lab(28.0014% -.778109 -7.34471);--wuxing-water-bg:lab(24.4811% -7.8918 -24.9024);--dm-border:lab(67.5362% 14.8294 64.5914);--dm-bg:lab(9.55197% 1.60985 7.31485)}}@media (prefers-color-scheme:light){:root{--bg-primary:#f3f5f9;--bg-secondary:#e7ebf2;--bg-tertiary:#d8dee8;--bg-hover:#d0d8e5;--border:#bdc5d1;--border-subtle:#d2d8e2;--text-primary:#0f1216;--text-secondary:#414853;--text-muted:#6c727b;--accent:#0065b2;--accent-warm:#966800;--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light;--wuxing-wood:#005f0e;--wuxing-fire:#a20519;--wuxing-earth:#805300;--wuxing-metal:#48566c;--wuxing-water:#005380;--wuxing-wood-bg:#c0e3c0;--wuxing-fire-bg:#fdc9c4;--wuxing-earth-bg:#f2daba;--wuxing-metal-bg:#d6dfec;--wuxing-water-bg:#b4defc;--dm-border:#966800;--dm-bg:#f6ede0}@supports (color:color(display-p3 0 0 0)){:root{--bg-primary:color(display-p3 .95471 .961142 .973263);--bg-secondary:color(display-p3 .909797 .922535 .946581);--bg-tertiary:color(display-p3 .852455 .871315 .906983);--bg-hover:color(display-p3 .821139 .84609 .893374);--border:color(display-p3 .745559 .770059 .816515);--border-subtle:color(display-p3 .826933 .845684 .881152);--text-primary:color(display-p3 .0608605 .0691527 .0850621);--text-secondary:color(display-p3 .261513 .281801 .32064);--text-muted:color(display-p3 .429297 .445909 .477439);--accent:color(display-p3 .143802 .388951 .683672);--accent-warm:color(display-p3 .596632 .396992 -.158844);--wuxing-wood:color(display-p3 .0968244 .374385 .0683277);--wuxing-fire:color(display-p3 .580784 .119608 .128804);--wuxing-earth:color(display-p3 .489279 .326588 -.0287041);--wuxing-metal:color(display-p3 .294019 .335238 .415486);--wuxing-water:color(display-p3 -.0775243 .316124 .547443);--wuxing-wood-bg:color(display-p3 .778394 .884493 .76257);--wuxing-fire-bg:color(display-p3 .959986 .795906 .773571);--wuxing-earth-bg:color(display-p3 .93331 .858308 .743829);--wuxing-metal-bg:color(display-p3 .84663 .871726 .919277);--wuxing-water-bg:color(display-p3 .739548 .864306 .975015);--dm-border:color(display-p3 .596632 .396992 -.158844);--dm-bg:color(display-p3 .957692 .931855 .88349)}}@supports (color:lab(0% 0 0)){:root{--bg-primary:lab(96.5044% -.267148 -1.87216);--bg-secondary:lab(93.0079% -.518024 -3.73493);--bg-tertiary:lab(88.3503% -.749856 -5.58736);--bg-hover:lab(86.0117% -.963002 -7.43048);--border:lab(79.0511% -.952899 -7.42528);--border-subtle:lab(86.0302% -.748128 -5.58645);--text-primary:lab(5.23796% -.285208 -3.0582);--text-secondary:lab(30.3224% -.794604 -7.35167);--text-muted:lab(47.7476% -.701487 -5.56231);--accent:lab(41.1205% -1.70796 -50.1423);--accent-warm:lab(47.6194% 20.1868 104.51);--wuxing-wood:lab(34.5429% -45.3762 42.1829);--wuxing-fire:lab(34.3495% 57.1812 37.8813);--wuxing-earth:lab(39.4811% 17.4358 64.8795);--wuxing-metal:lab(36.0172% -1.09252 -14.5181);--wuxing-water:lab(32.2784% -8.65509 -43.065);--wuxing-wood-bg:lab(86.8562% -16.7675 13.1583);--wuxing-fire-bg:lab(85.5193% 18.485 10.0423);--wuxing-earth-bg:lab(88.4503% 4.9783 19.0112);--wuxing-metal-bg:lab(88.3319% -.966102 -7.43206);--wuxing-water-bg:lab(86.1283% -8.87641 -19.3614);--dm-border:lab(47.6194% 20.1868 104.51);--dm-bg:lab(94.2538% 1.22291 7.5882)}}}html,body{background:var(--bg-primary);width:100%;height:100%;color:var(--text-primary);font-family:system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Noto Sans,Ubuntu,Cantarell,Helvetica Neue,sans-serif;font-size:13px;line-height:1.5;overflow:hidden}body{flex-direction:column;display:flex}#app{flex-direction:column;flex:1;display:flex;overflow:hidden}#loading-state{color:var(--text-secondary);flex-direction:column;flex:1;justify-content:center;align-items:center;gap:12px;display:flex}#loading-state[hidden]{display:none}.oe-loader{width:48px;height:48px;animation:1.2s linear infinite spin}.oe-loader circle{fill:none;stroke:var(--accent);stroke-width:3px;stroke-dasharray:200;stroke-dashoffset:80px;stroke-linecap:round}@keyframes spin{to{transform:rotate(360deg)}}.chart-status{background:var(--bg-secondary);border-top:1px solid var(--border-subtle);color:var(--text-muted);opacity:0;z-index:50;padding:6px 14px;font-size:11px;transition:opacity .2s,transform .2s;position:fixed;bottom:0;left:0;right:0;transform:translateY(100%)}.chart-status.visible{opacity:1;transform:translateY(0)}#bazi-container{flex-direction:column;flex:1;gap:16px;padding:16px;display:flex;overflow-y:auto}#bazi-container[hidden]{display:none}.bazi-pillars{grid-template-columns:repeat(4,1fr);gap:8px;animation:.6s ease-out bazi-fade-in;display:grid}@keyframes bazi-fade-in{0%{opacity:0;transform:translateY(8px)}to{opacity:1;transform:translateY(0)}}.bazi-pillar{border:1px solid var(--border-subtle);border-radius:var(--radius);background:var(--bg-secondary);cursor:pointer;flex-direction:column;transition:border-color .15s,box-shadow .15s,transform .15s;display:flex;overflow:hidden}.bazi-pillar:hover{border-color:var(--border);transform:translateY(-1px);box-shadow:0 2px 12px rgba(0,0,0,.1);box-shadow:0 2px 12px color(display-p3 0 0 0/.1);box-shadow:0 2px 12px lab(0% 0 0/.1)}.bazi-pillar--dm{border-color:var(--dm-border);background:var(--dm-bg);box-shadow:inset 3px 0 0 var(--dm-border), inset -3px 0 0 var(--dm-border)}.bazi-pillar--dm:hover{border-color:var(--dm-border);box-shadow:inset 3px 0 0 var(--dm-border), inset -3px 0 0 var(--dm-border), 0 4px 16px rgba(210,153,34,.15)}@supports (color:color(display-p3 0 0 0)){.bazi-pillar--dm:hover{box-shadow:inset 3px 0 0 var(--dm-border), inset -3px 0 0 var(--dm-border), 0 4px 16px color(display-p3 .789908 .60997 .245434/.15)}}@supports (color:lab(0% 0 0)){.bazi-pillar--dm:hover{box-shadow:inset 3px 0 0 var(--dm-border), inset -3px 0 0 var(--dm-border), 0 4px 16px lab(67.5362% 14.8294 64.5914/.15)}}.bazi-pillar-header{text-transform:uppercase;letter-spacing:.08em;color:var(--text-muted);background:var(--bg-tertiary);border-bottom:1px solid var(--border-subtle);justify-content:center;align-items:center;gap:4px;padding:6px 8px;font-size:10px;font-weight:700;display:flex}.bazi-pillar--dm .bazi-pillar-header{color:var(--dm-border)}.dm-badge{background:var(--dm-border);color:#090b0f;color:color(display-p3 .036047 .0438664 .059078);color:lab(3.02674% -.179462 -2.15476);letter-spacing:.04em;border-radius:10px;padding:1px 5px;font-size:9px;font-weight:700}@media (prefers-color-scheme:light){.dm-badge{color:#fcf8f1;color:color(display-p3 .985424 .972455 .948118);color:lab(97.7087% .579864 3.77247)}}.bazi-stem-zone{border-bottom:1px solid var(--border-subtle);flex-direction:column;align-items:center;gap:2px;padding:10px 8px;display:flex}.bazi-stem-chinese{font-size:28px;font-weight:700;line-height:1.1}.bazi-stem-name{color:var(--text-secondary);font-size:11px;font-weight:600}.bazi-stem-element{color:var(--bg-primary);border-radius:10px;padding:1px 6px;font-size:10px;font-weight:500}@media (prefers-color-scheme:light){.bazi-stem-element{color:#fff6f8;color:color(display-p3 .992746 .964982 .972458);color:lab(97.5544% 3.37881 .0330448)}}.bazi-branch-zone{border-bottom:1px solid var(--border-subtle);flex-direction:column;align-items:center;gap:2px;padding:10px 8px;display:flex}.bazi-branch-animal-emoji{font-size:22px;line-height:1.1}.bazi-branch-name{color:var(--text-secondary);font-size:11px;font-weight:600}.bazi-branch-animal{color:var(--text-muted);font-size:10px}.bazi-hidden-zone{flex-direction:column;align-items:center;gap:3px;min-height:48px;padding:6px 8px;display:flex}.bazi-hidden-label{text-transform:uppercase;letter-spacing:.06em;color:var(--text-muted);margin-bottom:1px;font-size:9px;font-weight:600}.bazi-hidden-stems{flex-wrap:wrap;justify-content:center;gap:6px;display:flex}.bazi-hidden-stem{flex-direction:column;align-items:center;gap:1px;display:flex}.bazi-hidden-char{font-size:16px;font-weight:600;line-height:1.1}.bazi-hidden-strength{opacity:.7;border-radius:50%;width:6px;height:6px}.bazi-hidden-strength--main{opacity:1}.bazi-hidden-strength--secondary{opacity:.65}.bazi-hidden-strength--residual{opacity:.35}.bazi-ten-god-tag{background:var(--bg-hover);color:var(--text-secondary);border-radius:10px;padding:1px 5px;font-size:9px;font-weight:600}.bazi-balance{background:var(--bg-secondary);border:1px solid var(--border-subtle);border-radius:var(--radius);flex-direction:column;gap:8px;padding:12px 14px;animation:.8s ease-out .2s both bazi-fade-in;display:flex}.bazi-balance-header{justify-content:space-between;align-items:center;display:flex}.bazi-balance-title{text-transform:uppercase;letter-spacing:.06em;color:var(--text-muted);font-size:11px;font-weight:700}.bazi-balance-strength{background:var(--bg-hover);color:var(--text-secondary);border-radius:10px;padding:2px 8px;font-size:11px;font-weight:600}.bazi-balance-strength--strong{color:var(--wuxing-wood)}.bazi-balance-strength--weak{color:var(--wuxing-fire)}.bazi-bar-container{border-radius:var(--radius-sm);border:1px solid var(--border-subtle);height:28px;display:flex;overflow:hidden}.bazi-bar-segment{min-width:24px;color:var(--text-primary);justify-content:center;align-items:center;font-size:10px;font-weight:700;transition:flex .4s ease-out;display:flex;position:relative;overflow:hidden}.bazi-bar-segment-label{opacity:.8;white-space:nowrap;font-size:9px}.bazi-bar-legend{flex-wrap:wrap;justify-content:center;gap:12px;display:flex}.bazi-legend-item{color:var(--text-secondary);cursor:pointer;align-items:center;gap:4px;font-size:11px;transition:color .15s;display:flex}.bazi-legend-item:hover{color:var(--text-primary)}.bazi-legend-dot{border-radius:50%;flex-shrink:0;width:8px;height:8px}.bazi-legend-pct{font-variant-numeric:tabular-nums;font-weight:700}.bazi-legend-score{color:var(--text-muted);font-size:10px}.bazi-yongshen{border-radius:var(--radius-sm);background:var(--bg-tertiary);border:1px solid var(--border-subtle);color:var(--text-secondary);justify-content:center;align-items:center;gap:6px;padding:6px 12px;font-size:12px;display:flex}.bazi-yongshen-label{color:var(--text-muted);font-weight:500}.bazi-yongshen-value{font-weight:700}.bazi-drawer-overlay{z-index:60;opacity:0;background:rgba(0,0,0,.4);background:color(display-p3 0 0 0/.4);background:lab(0% 0 0/.4);transition:opacity .2s;position:fixed;top:0;bottom:0;left:0;right:0}.bazi-drawer-overlay.visible{opacity:1}.bazi-drawer{background:var(--bg-secondary);border-top:1px solid var(--border);border-radius:var(--radius-lg) var(--radius-lg) 0 0;z-index:61;max-height:60vh;padding:16px;transition:transform .25s ease-out;position:fixed;bottom:0;left:0;right:0;overflow-y:auto;transform:translateY(100%)}.bazi-drawer.visible{transform:translateY(0)}.bazi-drawer-handle{background:var(--border);border-radius:2px;width:36px;height:4px;margin:0 auto 12px}.bazi-drawer-title{align-items:center;gap:8px;margin-bottom:12px;font-size:15px;font-weight:700;display:flex}.bazi-drawer-section{margin-bottom:12px}.bazi-drawer-section-title{text-transform:uppercase;letter-spacing:.06em;color:var(--text-muted);margin-bottom:6px;font-size:10px;font-weight:700}.bazi-drawer-ten-god{background:var(--bg-tertiary);border-radius:var(--radius-sm);align-items:center;gap:10px;margin-bottom:6px;padding:8px 10px;display:flex}.bazi-drawer-tg-chinese{font-size:22px;font-weight:700}.bazi-drawer-tg-info{flex-direction:column;gap:1px;display:flex}.bazi-drawer-tg-name{font-size:13px;font-weight:600}.bazi-drawer-tg-category{color:var(--text-muted);text-transform:capitalize;font-size:11px}.bazi-drawer-hidden-table{border-collapse:collapse;width:100%;font-size:12px}.bazi-drawer-hidden-table th{text-transform:uppercase;letter-spacing:.04em;color:var(--text-muted);text-align:left;border-bottom:1px solid var(--border-subtle);padding:4px 8px;font-size:10px;font-weight:700}.bazi-drawer-hidden-table td{border-bottom:1px solid var(--border-subtle);color:var(--text-secondary);padding:5px 8px}.bazi-drawer-hidden-table tr:last-child td{border-bottom:none}.bazi-actions{flex-wrap:wrap;gap:8px;animation:.8s ease-out .4s both bazi-fade-in;display:flex}.action-btn{border-radius:var(--radius);border:1px solid var(--border);background:var(--bg-secondary);color:var(--text-secondary);cursor:pointer;align-items:center;gap:4px;padding:8px 14px;font-size:12px;font-weight:600;transition:background .15s,color .15s,box-shadow .15s;display:inline-flex}.action-btn:hover{background:var(--bg-hover);color:var(--text-primary)}.action-btn--primary{color:#cbdfff;color:color(display-p3 .811259 .873257 .992208);color:lab(88.2011% -1.89927 -18.3428);background:linear-gradient(135deg,#1d4587,#32326d);background:linear-gradient(135deg,color(display-p3 .153533 .2659 .511983),color(display-p3 .195291 .194916 .412031));background:linear-gradient(135deg,lab(29.3399% 5.63866 -42.0206),lab(23.3003% 14.2058 -35.0966));border-color:#33548c;border-color:color(display-p3 .229049 .327581 .533696);border-color:lab(35.4848% 1.84765 -35.3079)}.action-btn--primary:hover{background:linear-gradient(135deg,#2151a1,#3d3c86);background:linear-gradient(135deg,color(display-p3 .180134 .31482 .611657),color(display-p3 .239239 .236673 .50744));background:linear-gradient(135deg,lab(34.9279% 7.15981 -48.9835),lab(28.8006% 17.5515 -42.0715));box-shadow:0 2px 12px rgba(29,69,135,.3);box-shadow:0 2px 12px color(display-p3 .153533 .2659 .511983/.3);box-shadow:0 2px 12px lab(29.3399% 5.63866 -42.0206/.3)}.error-state,.empty-state{text-align:center;flex-direction:column;flex:1;justify-content:center;align-items:center;gap:8px;padding:32px;display:flex}.error-icon,.empty-icon{font-size:32px}.tooltip{z-index:100;border-radius:var(--radius-sm);background:var(--bg-tertiary);border:1px solid var(--border);color:var(--text-primary);pointer-events:none;opacity:0;max-width:200px;padding:6px 10px;font-size:11px;transition:opacity .15s;position:fixed}.tooltip.visible{opacity:1}@media (max-width:360px){.bazi-stem-chinese{font-size:22px}.bazi-branch-animal-emoji{font-size:18px}.bazi-hidden-char{font-size:13px}.bazi-pillar-header{padding:4px 6px;font-size:9px}#bazi-container{gap:10px;padding:10px}.bazi-pillars{gap:4px}}.chart-layer{opacity:1;transform-origin:310px 310px;animation:.5s cubic-bezier(.16,1,.3,1) both svgLayerAssemble;animation-delay:calc(var(--layer-index,0) * 80ms);transform:scale(1)}@keyframes svgLayerAssemble{0%{opacity:0;transform:scale(.97)}to{opacity:1;transform:scale(1)}}.floating-action-btn:after{content:"";background:linear-gradient(90deg,transparent,rgba(255,255,255,.2),transparent);width:50%;height:100%;animation:3s 2s infinite shimmer;position:absolute;top:0;left:-100%;transform:skew(-20deg)}@keyframes shimmer{0%{left:-100%}20%{left:200%}to{left:200%}}@keyframes slideUpFadeIn{0%{opacity:0;transform:translateY(20px)}to{opacity:1;transform:translateY(0)}}@keyframes slideUpFadeInPanel{0%{opacity:0;transform:translateY(12px)scale(.98)}to{opacity:1;transform:translateY(0)scale(1)}}
 /*$vite$:1*/</style>
-</head>
-<body>
-  <div id="app">
-    <div id="loading-state">
-      <svg class="oe-loader" viewBox="0 0 100 100"><circle cx="50" cy="50" r="45"/></svg>
-      <p>Computing Four Pillars…</p>
-    </div>
-    <div id="chart-status" class="chart-status" role="status" aria-live="polite"></div>
-    <div id="bazi-container" hidden></div>
-    <div id="tooltip" class="tooltip" role="tooltip"></div>
-  </div>
-
+</head>
+<body>
+  <div id="app">
+    <div id="loading-state">
+      <svg class="oe-loader" viewBox="0 0 100 100"><circle cx="50" cy="50" r="45"/></svg>
+      <p>Computing Four Pillars…</p>
+    </div>
+    <div id="chart-status" class="chart-status" role="status" aria-live="polite"></div>
+    <div id="bazi-container" hidden></div>
+    <div id="tooltip" class="tooltip" aria-live="polite"></div>
+  </div>
+
 <script type="module">(function() {
   let e2 = document.createElement("link").relList;
   if (e2 && e2.supports && e2.supports("modulepreload")) return;
@@ -209,5 +209,5 @@ function A(e2) {
 }
 document.readyState === "loading" ? document.addEventListener("DOMContentLoaded", S) : S();
 </script>
-</body>
-</html>
+</body>
+</html>