@openephemeris/mcp-server 3.21.0 → 3.22.0

package/CHANGELOG.md

@@ -7,6 +7,30 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [3.22.0] — 2026-07-19
+
+Mobile/dark QA sweep across the four live iframe apps (chart-wheel, bi-wheel, bodygraph, moon-phase), plus a design-parity pass bringing the wheels' colors in line with the web app's #239 engine redesign.
+
+### Added
+- **Pinch-to-zoom + reliable touch pan** on chart-wheel, bi-wheel, and bodygraph — `touch-action: none` on the chart SVG stops mobile browsers from claiming drags for page scroll and pinches for page zoom; two-finger pinch zooms anchored at the gesture midpoint with simultaneous pan.
+- **Midpoint aspect-type glyphs** on the natal chart wheel — every aspect line now shows its symbol (☌ ☍ △ □ ⚹) on a backing disc, matching the bi-wheel app and the Go engine's design.
+- **Theme-aware HD transit/connection overlays** — `explore_human_design_transit` and `explore_human_design_connection` now pass `visual_config.theme` (previously always defaulted to light server-side) and re-fetch in the host's detected theme via the embedded app.
+
+### Fixed
+- **HD transit/connection overlays no longer error-card** in MCP Apps hosts — both tools' payloads nest the chart under `natal` / `composite_chart` (with a `centers` map shape the app didn't handle), which the bodygraph app's validity gate rejected outright.
+- **Chart-wheel and bi-wheel color palette** now matches the web app's #239 wheel redesign (element remap, vibrant dark-mode zodiac tints, warm/cool aspect semantics) — the iframe wheels had never received that pass and read muddy by comparison.
+- Zodiac sign glyphs no longer occasionally render as the wrong emoji-presentation glyph (missing `U+FE0E` variation selector).
+- Light-host theme detection no longer misreads as dark in some hosts (background-luminance probe used the wrong color space).
+- **ASC/DSC angle labels** no longer clip at the edge of the wheel on full-bleed mobile hosts (a `viewBox` overflow needing container padding that phones don't provide) — coordinates are now clamped inside the frame.
+- Mobile pan/zoom controls shrink to 32px with a translucent, blurred background and an icon-only Reset button, so the control stack stops covering the chart at phone widths.
+
+## [3.21.1] — 2026-07-12
+
+### Changed
+- **"Developer tier" renamed to "Pro tier"** in all user-facing copy, matching the site-wide rename (the internal plan id `developer` and `/pricing?plan=developer` URLs are unchanged). Updated the `explore_human_design_transit` / `explore_human_design_connection` tool descriptions, the `transit_search` range-limit note, and the astrocartography / API-reference / setup skill docs. Historical changelog entries below retain the old name as a record of what shipped.
+
+---
+
 ## [3.21.0] — 2026-07-09
 
 Launch-readiness wave from the three-perspective master review (directory vetting, first-run UX, revenue red-team).

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

@@ -1323,7 +1323,7 @@ registerTool({
 });
 // ── Tool: explore_human_design_transit ───────────────────────────────────────
 // Personalized Human Design transit overlay (natal chart + a transiting moment).
-// Premium (Developer tier). Calls POST /human-design/transit-chart.
+// Premium (Pro tier). Calls POST /human-design/transit-chart.
 registerTool({
     name: "explore_human_design_transit",
     description: "Overlay the current (or a chosen) planetary transit on a person's natal Human Design bodygraph.\n\n" +
@@ -1331,7 +1331,7 @@ registerTool({
         "Highlights the channels a transit temporarily COMPLETES with the natal chart and any centers it " +
         "newly defines — the core of a Human Design transit reading. " +
         "Returns an interactive overlay bodygraph in MCP Apps-capable hosts (Claude Desktop), with a text " +
-        "summary fallback elsewhere. Premium (Developer tier). Calculated with NASA JPL DE440 ephemerides.",
+        "summary fallback elsewhere. Premium (Pro tier). Calculated with NASA JPL DE440 ephemerides.",
     inputSchema: {
         type: "object",
         properties: {
@@ -1348,6 +1348,12 @@ registerTool({
                 type: "string",
                 description: "Transit moment, ISO 8601. Defaults to now (UTC) when omitted.",
             },
+            theme: {
+                type: "string",
+                enum: ["light", "dark"],
+                description: "Visual theme for the overlay bodygraph. Set automatically by the embedded app to match " +
+                    "the host; defaults to dark. You normally never need to pass this.",
+            },
         },
         required: ["datetime"],
     },
@@ -1384,8 +1390,14 @@ registerTool({
             body.transit_datetime = { iso: ensureTimezone(String(args.transit_datetime)) };
         }
         const bundleAvailable = Boolean(getBodygraphBundle());
-        if (bundleAvailable)
+        // The Go endpoint defaults visual_config.theme to "light", which mismatches
+        // dark MCP hosts — mirror the natal path's explicit dark default. The
+        // iframe re-calls this tool with theme once it detects the host theme.
+        const theme = args.theme === "light" ? "light" : "dark";
+        if (bundleAvailable) {
             body.include_visual = true;
+            body.visual_config = { theme };
+        }
         const resp = await client.request("POST", "/human-design/transit-chart", { data: body });
         const transit = (resp?.transit ?? {});
         const completed = Array.isArray(transit.completed_channels) ? transit.completed_channels : [];
@@ -1400,7 +1412,14 @@ registerTool({
             (newCenters.length
                 ? `\n\nNewly-defined center${newCenters.length === 1 ? "" : "s"}: **${newCenters.join(", ")}** — a temporary shift while the transit holds.`
                 : "");
-        const payload = { ...resp, _svg: svg, server_version: SERVER_VERSION };
+        const payload = {
+            ...resp,
+            _svg: svg,
+            _theme: theme,
+            // Lets the iframe re-request this overlay in the host's theme.
+            _refetch: { tool: "explore_human_design_transit", args: { ...args } },
+            server_version: SERVER_VERSION,
+        };
         if (bundleAvailable && svg) {
             return {
                 content: [{ type: "text", text: summary }],
@@ -1412,7 +1431,7 @@ registerTool({
     },
 });
 // ── Tool: explore_human_design_connection ────────────────────────────────────
-// Two-person Human Design connection (synastry) overlay. Premium (Developer tier).
+// Two-person Human Design connection (synastry) overlay. Premium (Pro tier).
 // Calls POST /human-design/composite.
 registerTool({
     name: "explore_human_design_connection",
@@ -1420,7 +1439,7 @@ registerTool({
         "theory. CREDIT COST: 3 credits per call. Classifications: " +
         "electromagnetic (attraction), companionship (sameness), dominance (one defines), and " +
         "compromise (friction). Returns an interactive two-person overlay bodygraph in MCP Apps-capable " +
-        "hosts, with a text summary fallback elsewhere. Premium (Developer tier). NASA JPL DE440 ephemerides.",
+        "hosts, with a text summary fallback elsewhere. Premium (Pro tier). NASA JPL DE440 ephemerides.",
     inputSchema: {
         type: "object",
         properties: {
@@ -1446,6 +1465,12 @@ registerTool({
                 },
                 required: ["datetime"],
             },
+            theme: {
+                type: "string",
+                enum: ["light", "dark"],
+                description: "Visual theme for the overlay bodygraph. Set automatically by the embedded app to match " +
+                    "the host; defaults to dark. You normally never need to pass this.",
+            },
         },
         required: ["person_a", "person_b"],
     },
@@ -1473,8 +1498,12 @@ registerTool({
             subject_2: toSubject(args.person_b),
         };
         const bundleAvailable = Boolean(getBodygraphBundle());
-        if (bundleAvailable)
+        // Mirror the transit tool: explicit dark default, host-theme refetch.
+        const theme = args.theme === "light" ? "light" : "dark";
+        if (bundleAvailable) {
             body.include_visual = true;
+            body.visual_config = { theme };
+        }
         const resp = await client.request("POST", "/human-design/composite", { data: body });
         const connections = Array.isArray(resp?.connections) ? resp.connections : [];
         const svg = resp?.visual?.data;
@@ -1490,7 +1519,13 @@ registerTool({
             line("Dominance — one defines", "dominance") +
             line("Compromise — friction", "compromise") +
             (connections.length ? "" : " none.");
-        const payload = { ...resp, _svg: svg, server_version: SERVER_VERSION };
+        const payload = {
+            ...resp,
+            _svg: svg,
+            _theme: theme,
+            _refetch: { tool: "explore_human_design_connection", args: { ...args } },
+            server_version: SERVER_VERSION,
+        };
         if (bundleAvailable && svg) {
             return {
                 content: [{ type: "text", text: summary }],

package/dist/tools/specialized/transits.js

@@ -15,7 +15,7 @@ registerTool({
         "  Example: Uranus Opposition → transiting_planets=['uranus'], natal_points=['uranus'], aspect_angle=180\n" +
         "  Example: Outer planets to natal Sun/Moon → transiting_planets=['saturn','uranus','neptune','pluto'], natal_points=['sun','moon']\n\n" +
         "DEFAULT natal_points (when omitted): sun, moon, mercury, venus, mars, jupiter, saturn.\n" +
-        "SEARCH RANGE LIMITS: Explorer/PayG tier → 1 year max; Developer → 5 years; Startup → 10 years.\n" +
+        "SEARCH RANGE LIMITS: Explorer/PayG tier → 1 year max; Pro → 5 years; Startup → 10 years.\n" +
         "CREDIT COST: 6 credits per call.",
     inputSchema: {
         type: "object",