@openephemeris/mcp-server 3.13.9 → 3.13.10

package/dist/prompts.js

@@ -66,11 +66,15 @@ export const PROMPTS = [
             "   - **Equal** (ASC-based equal 30° divisions)\n" +
             "   - **Porphyry** (traditional trisection; works at all latitudes including polar)\n" +
             "   Default to Placidus if they're unsure.\n\n" +
-            "## Step 2 — Resolve Coordinates and Timezone\n" +
-            "- Convert the birth city to decimal latitude/longitude (e.g. Chicago → 41.8781, -87.6298)\n" +
-            "- Determine the **IANA timezone** for that location and birth year — historical DST matters\n" +
+            "## Step 2 — Resolve Coordinates and Timezone (MANDATORY)\n" +
+            "**Do NOT guess coordinates or timezones from memory.** Use the API tools to resolve them:\n\n" +
+            "**A) Geocode** — call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'City Name, Country' }`. This returns verified decimal lat/lon.\n\n" +
+            "**B) Timezone** — call `dev_call` with `method: 'POST'`, `path: '/timezone/lookup'`, " +
+            "`body: { latitude: ..., longitude: ..., datetime: 'YYYY-MM-DDTHH:MM:SS' }`. " +
+            "This returns the correct IANA timezone and UTC offset for the birth year, including historical DST.\n\n" +
             "- Format: pass `datetime` as local ISO 8601 (e.g. `1990-04-15T14:30:00`) " +
-            "and `timezone` as the IANA name. Do NOT append Z to a local birth time.\n\n" +
+            "and `timezone` as the IANA name returned by the lookup. Do NOT append Z to a local birth time.\n\n" +
             "## Step 3 — Tool Call\n" +
             "Make a single call to `ephemeris_natal_chart` with:\n" +
             "- `datetime`: local ISO 8601 (no Z)\n" +
@@ -83,8 +87,9 @@ export const PROMPTS = [
             "## Step 4 — Structure the Reading\n" +
             "Deliver the interpretation in this sequence:\n\n" +
             "### 1. Chart Overview\n" +
-            "- **Sect**: Day (Sun above horizon) or Night chart. Day chart = Saturn and Jupiter more prominent; " +
-            "Night chart = Moon and Venus more prominent. This flavors all dignity assessments.\n" +
+            "- **Sect**: Day (Sun above horizon) or Night chart. The benefic of sect (Jupiter by day, Venus by night) " +
+            "operates with more ease; the malefic of sect (Saturn by day, Mars by night) has its difficulty moderated. " +
+            "This flavors all dignity assessments.\n" +
             "- **Chart Shape**: Splash (scattered), Bucket (one handle planet), Bundle (concentrated arc), " +
             "Bowl (one hemisphere), Locomotive (270° arc), Seesaw (two opposing groups), etc.\n" +
             "  What does this say about where this person's energy concentrates?\n" +
@@ -102,7 +107,8 @@ export const PROMPTS = [
             "- **Angular planets** (1st, 4th, 7th, 10th) — most powerful\n" +
             "- **Dignified planets** (domicile/exaltation) — reliable, flowing energy\n" +
             "- **Debilitated planets** (detriment/fall) — areas requiring conscious integration\n" +
-            "- **Retrograde planets** — internalized, revisited themes\n\n" +
+            "- **Retrograde planets** — traditionally considered weakened or contrary in expression; " +
+            "modern practice reads them as internalized or revisited themes. Note both perspectives.\n\n" +
             "### 5. Key Aspects\n" +
             "Highlight the 4–6 tightest or most significant aspects:\n" +
             "- Conjunction (0°): fusion | Opposition (180°): polarity | Square (90°): friction/growth\n" +
@@ -110,8 +116,12 @@ export const PROMPTS = [
             "### 6. Major Aspect Patterns\n" +
             "Flag any: Stelliums (3+ conjunct), Grand Trines, Grand Crosses, T-Squares, Yods.\n\n" +
             "### 7. North Node Path\n" +
-            "Node sign and house = soul's evolutionary direction. South Node = karmic comfort zone.\n\n" +
-            "**Tone**: Warm, specific, and empowering. Every statement grounded in actual chart data.\n\n" +
+            "Node sign and house = the direction of growth and development. South Node = familiar patterns, " +
+            "innate talents, and tendencies that can become default comfort zones. " +
+            "(Note: 'past life' or 'karmic' framings are one interpretive tradition among several — present as such if the user requests that lens.)\n\n" +
+            "**Tone**: Warm, specific, and empowering. Every statement grounded in actual chart data.\n" +
+            "**Disclaimer**: Astrological interpretation is symbolic and interpretive, not predictive or diagnostic. " +
+            "Never present chart analysis as a substitute for professional medical, legal, or psychological advice.\n\n" +
             "## Step 5 — Close with Follow-Up Offers\n" +
             "After delivering the reading, ask which of these deeper layers they'd like to explore:\n" +
             "- **Dignities deep-dive** — call `ephemeris_dignities` to see which planets are in their strongest " +
@@ -136,8 +146,12 @@ export const PROMPTS = [
             "3. **Life areas to focus on** — career, relationships, creativity, finances, health, " +
             "relocation, spirituality. This guides which house transits to emphasize.\n" +
             "4. **Any major events coming up** they already know about — reframes the transits around real context\n\n" +
-            "## Step 2 — Resolve Coordinates and Timezone\n" +
-            "- Convert birth city → decimal lat/lon + IANA timezone\n" +
+            "## Step 2 — Resolve Coordinates and Timezone (MANDATORY)\n" +
+            "**Do NOT guess coordinates or timezones from memory.** Use the API tools:\n\n" +
+            "**A) Geocode** — call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'Birth City, Country' }`. Use the returned decimal lat/lon.\n\n" +
+            "**B) Timezone** — call `dev_call` with `method: 'POST'`, `path: '/timezone/lookup'`, " +
+            "`body: { latitude: ..., longitude: ..., datetime: 'YYYY-MM-DDTHH:MM:SS' }`.\n\n" +
             "- Set `start_date` to today and `end_date` to the end of the forecast window\n\n" +
             "## Step 3 — Tool Call Sequence\n" +
             "Two calls minimum, run sequentially:\n\n" +
@@ -163,8 +177,11 @@ export const PROMPTS = [
             "(e.g. 'Career inflection — Saturn MC + Jupiter trine Sun'). These are the dates to plan around.\n\n" +
             "### 🧭 How to Navigate\n" +
             "For each 🔴 major transit: one concrete, practical action — not just what it means, but what to *do*.\n\n" +
-            "**Tone**: Empowering. Transits are invitations, not things that happen *to* you. " +
-            "Frame difficult transits as growth opportunities. Avoid astro-dread.\n\n" +
+            "**Tone**: Empowering but honest. Frame transits as conditions that can be worked with, " +
+            "not inevitable forces. Avoid fatalism, but also avoid implying the person has total control over transit-level events. " +
+            "Difficult transits warrant clear, specific preparation — not vague reassurance.\n" +
+            "**Disclaimer**: Astrological interpretation is symbolic and interpretive, not predictive or diagnostic. " +
+            "Never present transit analysis as a substitute for professional advice.\n\n" +
             "## Step 5 — Follow-Up Offers\n" +
             "After delivering the forecast, offer to layer in:\n" +
             "- **Right now**: call `ephemeris_natal_transits` with today's UTC datetime to see what's " +
@@ -192,8 +209,12 @@ export const PROMPTS = [
             "5. **Type of relationship**: romantic, friendship, family, business partners?\n" +
             "6. **Primary question or concern** — what are they most curious/worried about?\n" +
             "7. **House system**: Placidus (default), Whole Sign, Koch, Equal?\n\n" +
-            "## Step 2 — Resolve Both Sets of Coordinates\n" +
-            "- Convert each birth city → decimal lat/lon + IANA timezone, independently\n" +
+            "## Step 2 — Resolve Both Sets of Coordinates (MANDATORY)\n" +
+            "**Do NOT guess coordinates or timezones.** For EACH person:\n\n" +
+            "**A) Geocode** — call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'Birth City, Country' }`.\n\n" +
+            "**B) Timezone** — call `dev_call` with `method: 'POST'`, `path: '/timezone/lookup'`, " +
+            "`body: { latitude: ..., longitude: ..., datetime: 'YYYY-MM-DDTHH:MM:SS' }`.\n\n" +
             "- Format: local ISO 8601 datetime (no Z) + IANA timezone name separately for each person\n" +
             "- Note if either birth time is unknown — flag this upfront before running tools\n\n" +
             "## Step 3 — Tool Call\n" +
@@ -229,7 +250,11 @@ export const PROMPTS = [
             "3 specific, actionable insights. What does this pairing need to thrive? " +
             "What pattern to consciously watch? What is the relationship's highest potential?\n\n" +
             "**Tone**: Balanced and honest. Hard aspects are opportunities. Never doom a connection " +
-            "on a single difficult cross-aspect.\n\n" +
+            "on a single difficult cross-aspect.\n" +
+            "**Ethical boundary**: Never advise someone to end, avoid, or pursue a relationship based on chart data alone. " +
+            "Astrology describes dynamics — it does not determine whether a relationship should exist.\n" +
+            "**Disclaimer**: Astrological interpretation is symbolic and interpretive, not predictive or diagnostic. " +
+            "Never present compatibility analysis as a substitute for professional relationship counseling.\n\n" +
             "## Step 5 — Follow-Up Offers\n" +
             "After the reading, offer:\n" +
             "- **Composite chart** — call `ephemeris_composite` to read the relationship as its own entity " +
@@ -256,9 +281,13 @@ export const PROMPTS = [
             "general quality of life — this shapes which planetary lines matter most\n" +
             "4. **What they already feel** about these cities — sometimes the chart confirms an intuition, " +
             "sometimes it explains why a place felt 'off'\n\n" +
-            "## Step 2 — Resolve Coordinates\n" +
-            "- Convert birth city → decimal lat/lon + IANA timezone\n" +
-            "- Convert each target city → decimal lat/lon\n" +
+            "## Step 2 — Resolve Coordinates (MANDATORY)\n" +
+            "**Do NOT guess coordinates or timezones.** Use the API tools:\n\n" +
+            "**A) Geocode birth city** — call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'Birth City, Country' }`.\n\n" +
+            "**B) Timezone** — call `dev_call` with `method: 'POST'`, `path: '/timezone/lookup'`, " +
+            "`body: { latitude: ..., longitude: ..., datetime: 'YYYY-MM-DDTHH:MM:SS' }`.\n\n" +
+            "**C) Geocode each target city** — repeat the autocomplete call for each destination city.\n\n" +
             "- Format birth datetime as local ISO 8601 (no Z), pass IANA timezone separately\n\n" +
             "## Step 3 — Tool Call Sequence\n" +
             "Two calls minimum. Start lean, offer more after delivery.\n\n" +
@@ -267,7 +296,9 @@ export const PROMPTS = [
             "- `birth_latitude` / `birth_longitude`: birth coords\n" +
             "- `query_latitude` / `query_longitude`: target city coords\n" +
             "- `radius_deg`: `3` (default ~300km; increase to `5` for rural/remote regions)\n" +
-            "- `include_aspects`: `true` (includes paran crossings, not just primary lines)\n\n" +
+            "- `include_aspects`: `true` (includes paran crossings, not just primary lines)\n" +
+            "  Note: paran crossings are secondary influences, less intense than primary angular lines. " +
+            "Present them as supporting texture, not headline themes.\n\n" +
             "This gives immediate, city-specific results for exactly what they asked about.\n\n" +
             "**B) Relocate the Chart** — for their single highest-interest city, call `ephemeris_relocation` with:\n" +
             "- `natal_datetime`, `natal_latitude`, `natal_longitude`\n" +
@@ -314,7 +345,9 @@ export const PROMPTS = [
             "[City A] stands out because [specific reason]. [City B] is worth a trial visit for [Y] but " +
             "caution around [Z].'\n\n" +
             "**Tone**: Practical and decisive. People use this for real decisions. Be honest about " +
-            "difficult lines — frame them as growth challenges, not red flags.\n\n" +
+            "genuinely challenging lines — Mars IC, Pluto IC, and Saturn DSC warrant clear cautions, " +
+            "not euphemistic reframing. Frame difficulty realistically, not dismissively. " +
+            "Avoid guaranteed prediction in either direction.\n\n" +
             "## Follow-Up Offers\n" +
             "After the reading, offer:\n" +
             "- **Global power line map** — call `acg_power_lines` to show ALL planetary lines worldwide, " +
@@ -338,13 +371,17 @@ export const PROMPTS = [
             "proceed with solar noon but flag that results may be imprecise.\n" +
             "4. **Birth city and country** — needed for timezone conversion\n\n" +
             "## Step 2 — CRITICAL: Convert to UTC\n" +
-            "Human Design requires **UTC datetime**. The tool rejects local times without a UTC offset.\n" +
-            "- Determine the IANA timezone for the birth location and year (historical DST applies)\n" +
-            "- Convert local birth time → UTC\n" +
+            "Human Design requires **UTC datetime**. The tool rejects local times without a UTC offset.\n\n" +
+            "**A) Geocode** — call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'Birth City, Country' }`.\n\n" +
+            "**B) Timezone** — call `dev_call` with `method: 'POST'`, `path: '/timezone/lookup'`, " +
+            "`body: { latitude: ..., longitude: ..., datetime: 'YYYY-MM-DDTHH:MM:SS' }`.\n" +
+            "This returns the UTC offset for the birth year, including historical DST.\n\n" +
+            "- Use the returned offset to convert local birth time → UTC\n" +
             "- Format as ISO 8601 with Z: e.g. `1990-04-15T19:30:00Z`\n\n" +
             "**Why HD needs UTC**: The system calculates two activation moments:\n" +
             "- **Personality (Conscious / Black)**: the birth datetime\n" +
-            "- **Design (Unconscious / Red)**: ~88° of Sun arc *before* birth (~88 days prior)\n" +
+            "- **Design (Unconscious / Red)**: 88° of the Sun's arc before birth (approximately 88–89 days, varying by season)\n" +
             "The API computes both from the single UTC birth datetime automatically.\n\n" +
             "## Step 3 — Call the Tools\n\n" +
             "**A) Full Chart** — call `human_design_chart` with:\n" +
@@ -383,30 +420,25 @@ export const PROMPTS = [
             "Interpret both lines of their profile number (e.g. 3/5, 2/4, 6/2). " +
             "Each line is a hexagram archetype: 1=Investigator, 2=Hermit, 3=Martyr, 4=Opportunist, " +
             "5=Heretic, 6=Role Model. The first line is conscious; the second is unconscious.\n\n" +
-            "### 4. Centers Analysis — Defined vs Open\n" +
-            "Go through all 9 Centers. For each:\n" +
-            "- **Defined** (colored in the bodygraph): consistent, reliable energy in this area\n" +
-            "- **Undefined/Open** (white): receptive, amplifying, inconsistent — wisdom comes from " +
-            "not over-identifying with the energy amplified here\n\n" +
-            "Centers: **Head** (inspiration/pressure) → **Ajna** (conceptualization) → **Throat** (expression/action) → " +
-            "**G/Identity** (direction/love/Self) → **Heart/Ego** (willpower/resources) → **Sacral** (life force/sexuality) → " +
-            "**Solar Plexus** (emotions/spirit) → **Root** (adrenaline/pressure) → **Spleen** (immune/intuition/fear)\n\n" +
+            "### 4. Centers — Defined vs Open Highlights\n" +
+            "Highlight the 2–3 most important defined centers and 1–2 key open centers. " +
+            "Don't walk through all 9 unless the user asks — focus on what shapes their daily experience most.\n" +
+            "- **Defined** = consistent, reliable energy in that area\n" +
+            "- **Undefined/Open** = receptive, amplifying — wisdom comes from not over-identifying here\n\n" +
             "### 5. Key Channels and Gates\n" +
-            "Highlight 3–5 defined channels (where two centers are bridged). Each channel is a full circuit:\n" +
-            "name it, describe what consistent energy it gives this person.\n" +
-            "Then note the 2–3 most prominent conscious gates (personality side = Black), " +
-            "especially if they are 'hanging' (not completing a channel) — these are themes the person " +
-            "seeks completion for through others.\n\n" +
+            "Highlight 2–3 defined channels and 1–2 prominent hanging gates (themes they seek through others).\n\n" +
             "### 6. Incarnation Cross\n" +
-            "Name the Cross and describe it as the overarching life theme and purpose. " +
-            "The Incarnation Cross is made from the Sun gate (conscious) + Earth gate (conscious) + " +
-            "Sun gate (design/unconscious) + Earth gate (unconscious).\n\n" +
-            "### 7. Living Your Design — Experiments\n" +
-            "Give 3 specific, concrete experiments the user can try in the next 30 days to embody their " +
-            "Type, Strategy, and Authority. Make them practical and immediately actionable.\n\n" +
+            "Name the Cross and describe it as the overarching life theme. Keep it to 2–3 sentences.\n\n" +
+            "### 7. One Experiment\n" +
+            "Give 1 specific, concrete experiment they can try this week to test their Strategy and Authority.\n\n" +
             "**Tone**: Curious and invitational. Human Design is meant to be experimented with, not believed. " +
-            "Frame everything as 'something to try' not 'who you are'. " +
-            "Offer Saturn/Chiron Return reading if they're near those ages.",
+            "Frame everything as 'something to try' not 'who you are'.\n\n" +
+            "## Step 5 — Go Deeper (Offer, Don't Dump)\n" +
+            "After the core reading, offer these as next steps:\n" +
+            "- **Full Centers walkthrough** — 'Want me to go through all 9 centers in detail?'\n" +
+            "- **Channel deep-dive** — explore specific channel meanings and activation patterns\n" +
+            "- **Planetary cycles** — Saturn Return (~29y), Chiron Return (~50y), Uranus Opposition (~42y)\n" +
+            "- **Compare charts** — connection chart with a partner, colleague, or family member",
     },
     // ─────────────────────────────────────────────────────────────────────────
     // 7. Electional Timing
@@ -425,6 +457,9 @@ export const PROMPTS = [
             "4. **Hard constraints** — dates they absolutely cannot use (prior commitments, venue availability)\n" +
             "5. **Any personal chart data?** If yes, run natal chart first and look for dates when the " +
             "moon triggers benefic natal planets.\n\n" +
+            "## Step 1.5 — Resolve Event Location (MANDATORY)\n" +
+            "**Do NOT guess coordinates.** Call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'Event City, Country' }` to get verified decimal lat/lon for the event location.\n\n" +
             "## Step 2 — Check the Planetary Weather First\n" +
             "Before scanning for windows:\n\n" +
             "**A) Station Check** — call `electional_station_tracker` with:\n" +
@@ -437,10 +472,15 @@ export const PROMPTS = [
             "## Step 3 — Electional Principles\n" +
             "Apply these rules when configuring the window search:\n\n" +
             "**Universal rules (all events):**\n" +
-            "- Avoid Void of Course Moon — nothing initiated under a VOC Moon 'comes of' the matter\n" +
+            "- Avoid Void of Course Moon — traditionally, 'nothing initiated under a VOC Moon comes to perfection.' " +
+            "(Note: 'VOC' definition varies by tradition. Hellenistic: Moon makes no applying Ptolemaic aspect " +
+            "before leaving its sign. Modern: Moon makes no applying major aspect to traditional planets. " +
+            "The API uses the modern definition.)\n" +
             "- Waxing Moon for new beginnings, growth, and outward actions\n" +
             "- Waning Moon for endings, release, reducing, and inward focus\n" +
-            "- Avoid Mercury Rx for contracts, communications, tech, travel arrangements\n" +
+            "- Mercury Rx: not ideal for signing *new* contracts or launching communications-dependent ventures. " +
+            "Traditionally better suited for re-negotiating, revising, or reviewing existing agreements. " +
+            "Not an absolute prohibition — weigh against other factors.\n" +
             "- Avoid Venus Rx for weddings, aesthetic procedures, major romantic commitments, expensive purchases\n" +
             "- Avoid Mars Rx for surgeries, confrontations, legal disputes, major physical initiatives\n\n" +
             "**Event-specific guidance:**\n" +
@@ -500,10 +540,14 @@ export const PROMPTS = [
             "   - **Fagan-Bradley** — Western sidereal standard\n" +
             "   - **Yukteshwar** — based on Sri Yukteswar's *The Holy Science*\n" +
             "   Default to Lahiri if unsure.\n\n" +
-            "## Step 2 — Convert to UTC\n" +
-            "The `vedic_chart` tool requires a UTC datetime (with Z suffix):\n" +
-            "- Determine the IANA timezone for the birth city and year (historical DST applies)\n" +
-            "- Convert local birth time → UTC\n" +
+            "## Step 2 — Convert to UTC (MANDATORY)\n" +
+            "The `vedic_chart` tool requires a UTC datetime (with Z suffix):\n\n" +
+            "**A) Geocode** — call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'Birth City, Country' }`.\n\n" +
+            "**B) Timezone** — call `dev_call` with `method: 'POST'`, `path: '/timezone/lookup'`, " +
+            "`body: { latitude: ..., longitude: ..., datetime: 'YYYY-MM-DDTHH:MM:SS' }`.\n" +
+            "This returns the correct IANA timezone and UTC offset for the birth year, including historical DST.\n\n" +
+            "- Use the returned offset to convert local birth time → UTC\n" +
             "- Format: `1990-01-15T03:00:00Z`\n\n" +
             "## Step 3 — Call the Tool\n" +
             "Call `vedic_chart` with:\n" +
@@ -513,54 +557,40 @@ export const PROMPTS = [
             "- `ayanamsa`: user's choice or `'lahiri'`\n\n" +
             "## Step 4 — contextual Frame: Vedic vs Western\n" +
             "Brief the user (if they're Western-trained) on key differences:\n" +
-            "- **Sidereal zodiac**: planetary positions are ~23–24° earlier than tropical. Their 'Western Aries' " +
-            "Sun is likely **Pisces** or late **Aquarius** in the sidereal chart.\n" +
+            "- **Sidereal zodiac**: planetary positions shift approximately 24° earlier compared to tropical. " +
+            "A Sun at 25° Aries tropical ≈ 1° Aries sidereal. A Sun at 10° Aries tropical ≈ 16° Pisces sidereal. " +
+            "The exact offset depends on the chosen ayanamsa (Lahiri ~24°07' in 2026).\n" +
             "- **Whole Sign Bhavas**: the Lagna's sign = the entire 1st Bhava. No intercepted signs.\n" +
             "- **Nakshatras**: 27 lunar mansions of ~13°20' each — the heart of timing and soul-level analysis\n" +
             "- **The Moon is king**: in Jyotish the Moon holds more weight than the Sun for disposition and timing\n" +
             "- **Guna of chart**: Sattvic (clear, spiritual), Rajasic (active, worldly), or Tamasic (inert)?\n\n" +
             "## Step 5 — Structure the Reading\n\n" +
-            "### The Lagna (Ascendant) — First and Always\n" +
-            "- Which rashi (sidereal sign) is rising?\n" +
-            "- Who is the Lagna lord? In which bhava and rashi does it sit? What is its dignity status?\n" +
-            "- Any grahas (planets) occupying the Lagna — they color the personality most strongly\n" +
-            "- A strong Lagna lord + strong Lagna = resilient, capable person regardless of other chart factors\n\n" +
-            "### The Moon (Chandra) — Emotional Core\n" +
-            "- Rashi (sidereal sign) and Bhava\n" +
-            "- **Nakshatra**: name (in Sanskrit + English), presiding deity, symbol, quality (Deva/Manushya/Rakshasa)\n" +
-            "- **Pada** (quarter, 1–4): the navamsa sub-sign this nakshatra pada maps to\n" +
-            "- Paksha: Shukla (waxing, bright — stronger) or Krishna (waning, dark)?\n" +
-            "- Moon's aspects (Vedic full-sign aspects): which grahas aspect the Moon?\n\n" +
-            "### The Sun (Surya)\n" +
-            "- Rashi, Bhava, Nakshatra, dignity, aspects\n" +
-            "- Is it combust any planet (within ~6°)? Combust planets lose their power.\n\n" +
-            "### Planetary Dignity Survey\n" +
-            "For each of the 7 classical grahas (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn) + Rahu/Ketu:\n" +
-            "- Sign placement + dignity status: uchcha (exalted), swa (own sign), mitra (friend), " +
-            "sama (neutral), shatru (enemy), neecha (fallen)\n" +
-            "- Which bhava?\n" +
-            "- Are they retrograde (vakra)? Retrograde planets express their nature more intensely.\n\n" +
-            "### Key Yogas\n" +
-            "Scan for the most impactful combinations:\n" +
-            "- **Raj Yoga**: Kendra lord (1,4,7,10) + Trikona lord (1,5,9) in conjunction or mutual aspect\n" +
-            "- **Dhana Yoga**: 2nd + 11th lord combinations → wealth accumulation\n" +
-            "- **Neecha Bhanga Raj Yoga**: fallen planet whose debilitation is cancelled → immense strength\n" +
-            "- **Gajakesari Yoga**: Jupiter in Kendra from Moon → wisdom and good fortune\n" +
-            "- **Parivartana (Mutual Reception)**: two planets in each other's signs → exchanged strength\n" +
-            "- **Viparita Raj Yoga**: lords of dusthanas (6, 8, 12) in other dusthanas → triumph through adversity\n\n" +
-            "### Navamsa (D9) Highlights\n" +
-            "The navamsa reveals the soul's deeper purpose and the quality of relationships:\n" +
-            "- Where does the Lagna lord fall in D9? That bhava is additionally activated.\n" +
-            "- Where do the luminaries (Sun/Moon) land in D9?\n" +
-            "- Vargottama planets (same sign in D1 and D9) are especially strong — note these.\n\n" +
-            "### Vimshottari Dasha (Planetary Periods)\n" +
-            "If the API returns Dasha data:\n" +
-            "- **Current Maha Dasha** (major 6–20 year period) and its lord's chart condition\n" +
-            "- **Current Antardasha** (sub-period, ~1–3 years) and its lord's interaction with the major lord\n" +
-            "- **Next Maha Dasha change**: when it arrives and what themes to expect\n\n" +
-            "**Tone**: Respectful of the tradition's depth. Use Sanskrit terms with English equivalents in parentheses. " +
-            "Reference the Vedic philosophical framework (dharma, artha, kama, moksha) where appropriate. " +
-            "Jyotish is a practical science — always relate chart factors to real life arenas.",
+            "### The Lagna (Ascendant)\n" +
+            "- Rising rashi, Lagna lord placement and dignity\n" +
+            "- Any grahas in the Lagna\n\n" +
+            "### The Moon (Chandra)\n" +
+            "- Rashi, Bhava, Nakshatra (name + deity + quality), Pada\n" +
+            "- Paksha: Shukla (waxing) or Krishna (waning)\n\n" +
+            "### Planetary Dignity Highlights\n" +
+            "Don't walk through all 9 grahas exhaustively. Highlight:\n" +
+            "- Any exalted (uchcha) or fallen (neecha) planets — these dominate the chart\n" +
+            "- The most angular planets (Kendras 1, 4, 7, 10)\n" +
+            "- Retrograde planets — note, but don't overweight\n\n" +
+            "### Top 2–3 Yogas\n" +
+            "Scan for the most impactful: Raj Yoga, Gajakesari, Neecha Bhanga, Parivartana. " +
+            "Name them, explain in plain English what they promise.\n\n" +
+            "### Current Dasha Period\n" +
+            "If the API returns Dasha data, name the current Maha Dasha and Antardasha. " +
+            "What life themes are active right now?\n\n" +
+            "**Tone**: Respectful of the tradition's depth. Use Sanskrit terms with English equivalents. " +
+            "Keep the reading grounded in practical life arenas.\n\n" +
+            "## Step 6 — Go Deeper (Offer, Don't Dump)\n" +
+            "After the core reading, offer:\n" +
+            "- **Full graha-by-graha walkthrough** — all 9 planets in detail\n" +
+            "- **Navamsa (D9)** — the soul chart and relationship layer\n" +
+            "- **Extended Yoga analysis** — Dhana Yoga, Viparita Raj Yoga, etc.\n" +
+            "- **Nakshatra deep-dive** — all planet nakshatras, not just Moon\n" +
+            "- **Transit overlay** — current Gochar transits to the sidereal natal chart",
     },
     // ─────────────────────────────────────────────────────────────────────────
     // 9. BaZi Four Pillars of Destiny
@@ -590,6 +620,8 @@ export const PROMPTS = [
             "this difference is small, but it can shift the hour animal by one block for cities far " +
             "from their timezone meridian (e.g. western Xinjiang in China UTC+8, western Spain in CET).\n" +
             "Pass individual date/time components — do NOT convert to UTC.\n\n" +
+            "**Geocode the birth city** — call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'Birth City, Country' }` to get verified coordinates for longitude offset calculation.\n\n" +
             "## Step 3 — Call the Tool\n" +
             "Call `chinese_bazi` with:\n" +
             "- `year`: birth year\n" +
@@ -629,38 +661,25 @@ export const PROMPTS = [
             "- **Weak DM** benefits from elements that produce it (印 Yìn) or match it (比劫 Bǐ Jié)\n" +
             "Give a plain-English verdict: 'Your [DM] is [strong/weak]. This means your favorable element is " +
             "[element], and you should [lifestyle advice around that element].'\n\n" +
-            "### Wu Xing (五行 Wǔ Xíng) — Five Elements Balance\n" +
-            "Count each element (Wood/Fire/Earth/Metal/Water) across all 8 characters. " +
-            "Which are abundant? Which are missing? The missing/scarce element is often the " +
-            "**yōng shén (用神)** — the favorable element to cultivate:\n" +
-            "- Wood → work with plants, growth, green colors, springtime\n" +
-            "- Fire → south-facing spaces, red/orange, social energy, summers\n" +
-            "- Earth → stability, yellow/brown, grounding, center\n" +
-            "- Metal → white, west direction, order, precision, autumn\n" +
-            "- Water → black/blue, north, stillness, wisdom, winters\n\n" +
-            "### Ten Gods (十神 Shí Shén) — The Relationship Map\n" +
-            "The Ten Gods describe how each other element relates to the Day Master:\n" +
-            "| Ten God | Relationship | Life Domain |\n" +
-            "|---------|-------------|-------------|\n" +
-            "| 正财 Direct Wealth | Controls DM (same polarity) | Steady income, discipline |\n" +
-            "| 偏财 Indirect Wealth | Controls DM (diff polarity) | Variable income, business |\n" +
-            "| 正官 Direct Officer | Controls DM (same polarity opposite) | Career, authority, fame |\n" +
-            "| 七杀 7 Killings | Controls DM (diff polarity opp.) | Power struggles, courage |\n" +
-            "| 正印 Direct Resource | Produces DM (same polarity) | Nurturing, education |\n" +
-            "| 偏印 Indirect Resource | Produces DM (diff polarity) | Unconventional learning |\n" +
-            "| 食神 Eating God | DM produces (same polarity) | Creativity, talents, pleasure |\n" +
-            "| 伤官 Hurting Officer | DM produces (diff polarity) | Self-expression, rebellion |\n" +
-            "| 比肩 Companion | Same element, same polarity | Peers, cooperation |\n" +
-            "| 劫财 Rob Wealth | Same element, diff polarity | Competition, loss, courage |\n\n" +
-            "### Luck Pillars (大运 Dàyùn)\n" +
-            "If the API returns Luck Pillar data:\n" +
-            "- Each Luck Pillar governs ~10 years of life\n" +
-            "- Identify the **current Luck Pillar** and its Stem/Branch\n" +
-            "- What Ten God does the Luck Pillar stem represent for this Day Master?\n" +
-            "- When does the next Luck Pillar begin and what themes does it introduce?\n\n" +
+            "### Wu Xing (五行) — Five Elements Balance\n" +
+            "Count each element across all 8 characters. Which are abundant? Which are missing? " +
+            "The scarce element is often the **yōng shén (用神)** — the favorable element to cultivate. " +
+            "Give one practical lifestyle suggestion tied to their favorable element.\n\n" +
+            "### Ten Gods — Headline Only\n" +
+            "Name the 2–3 most prominent Ten Gods in the chart (based on what appears in the pillars). " +
+            "Explain what each means for this person's life in plain language. " +
+            "Don't walk through all 10 unless the user asks.\n\n" +
+            "### Luck Pillars (大运)\n" +
+            "If the API returns Luck Pillar data, name the current 10-year pillar " +
+            "and the next transition. What themes shift?\n\n" +
             "**Tone**: Deeply respectful of the Chinese metaphysical tradition. Use Chinese terms " +
-            "with pinyin and brief English equivalents. Avoid reducing to fortune-telling; " +
-            "BaZi maps tendencies, timing, and elemental medicine — not fixed fate.",
+            "with pinyin and brief English equivalents. BaZi maps tendencies and timing — not fixed fate.\n\n" +
+            "## Step 6 — Go Deeper (Offer, Don't Dump)\n" +
+            "After the core reading, offer:\n" +
+            "- **Full Ten Gods walkthrough** — all 10 relationships mapped out\n" +
+            "- **Element remedy guide** — colors, directions, seasons, foods for their favorable element\n" +
+            "- **Annual pillar analysis** — how the current year's elements interact with their chart\n" +
+            "- **Compatibility** — compare BaZi charts with a partner",
     },
     // ─────────────────────────────────────────────────────────────────────────
     // 10. Current Sky Snapshot
@@ -736,12 +755,20 @@ export const PROMPTS = [
             "   The Solar Return chart is cast for wherever the person *physically is* when the Sun " +
             "   hits their natal degree. Being in a different city changes the SR Ascendant and house layout.\n" +
             "   If they haven't decided yet, calculate for both their home and any other city they're considering.\n" +
+            "   *(Note: Whether to cast the SR for the birth location or the birthday location is debated. " +
+            "The relocation SR technique is popular in modern practice but not universally accepted. " +
+            "If the user asks, acknowledge both approaches.)*\n" +
             "4. **House system**: Placidus (default), Whole Sign, Koch, Equal?\n\n" +
-            "## Step 2 — Resolve Data\n" +
-            "- Convert birth city → decimal lat/lon + IANA timezone\n" +
-            "- For `birth_datetime`, include the UTC offset: `1985-06-21T14:00:00-05:00`\n" +
-            "  (or convert to UTC with Z: `1985-06-21T19:00:00Z`)\n" +
-            "- Convert birthday location city → decimal lat/lon (this becomes `return_latitude`/`return_longitude`)\n\n" +
+            "## Step 2 — Resolve Data (MANDATORY)\n" +
+            "**Do NOT guess coordinates or timezones.** Use the API tools:\n\n" +
+            "**A) Geocode birth city** — call `dev_call` with `method: 'GET'`, `path: '/location/autocomplete'`, " +
+            "`query: { q: 'Birth City, Country' }`.\n\n" +
+            "**B) Timezone** — call `dev_call` with `method: 'POST'`, `path: '/timezone/lookup'`, " +
+            "`body: { latitude: ..., longitude: ..., datetime: 'YYYY-MM-DDTHH:MM:SS' }`.\n\n" +
+            "- For `birth_datetime`, include the UTC offset from the timezone lookup: `1985-06-21T14:00:00-05:00`\n" +
+            "  (or convert to UTC with Z: `1985-06-21T19:00:00Z`)\n\n" +
+            "**C) Geocode birthday location** — repeat the autocomplete call for the city where they'll be " +
+            "on their birthday. This becomes `return_latitude`/`return_longitude`.\n\n" +
             "## Step 3 — Tool Call\n" +
             "Two calls. Deliver the reading, then offer depth.\n\n" +
             "**A) Natal Baseline** — call `ephemeris_natal_chart` with `format='llm'` and `house_system` as chosen.\n" +
@@ -771,36 +798,21 @@ export const PROMPTS = [
             "- Sign and house: the emotional undertone running through the year\n" +
             "- SR Moon aspects: what shapes the emotional landscape?\n" +
             "- SR Moon in an angular house (1/4/7/10): emotions are front and center, highly active\n\n" +
-            "### Angular Planets — The Year's Protagonists\n" +
-            "Any planet on an SR angle (within 5°) is forcefully active this year:\n" +
-            "- **SR ASC**: colors personality and health\n" +
-            "- **SR IC**: major changes in home/family life\n" +
-            "- **SR DC**: partnerships and one-to-one relationships are pivotal\n" +
-            "- **SR MC**: career, reputation, and public direction is being remade\n\n" +
-            "### Key SR Planets\n" +
-            "- **Jupiter in SR**: which house gets expanded and blessed? Where is luck flowing?\n" +
-            "- **Saturn in SR**: which house demands serious work, limits, or restructuring?\n" +
-            "- **Any SR stellium**: a house with 3+ planets = the overwhelmingly dominant life theme\n\n" +
+            "### Angular Planets + Key Players\n" +
+            "Any planet on an SR angle (within 5°) is forcefully active this year. Name them. " +
+            "Then note where Jupiter (expansion) and Saturn (restructuring) land by house. " +
+            "A stellium (3+ planets in one house) = the overwhelmingly dominant theme.\n\n" +
             "### SR in Natal Context\n" +
-            "Overlay the SR planets into the natal houses (SR planets in natal house positions):\n" +
-            "Which natal life areas are 'lit up' by the Solar Return? This is where natal and SR interweave.\n\n" +
-            "### Location Optimization (if applicable)\n" +
-            "If they asked about a different SR location: explain clearly — 'If you're in [City X] on your " +
-            "birthday, the SR Ascendant shifts from [sign] to [sign], moving [planet] from house [X] to " +
-            "house [Y], which changes the year from a theme of [A] to a theme of [B].'\n\n" +
-            "### The Year's Power Months\n" +
-            "The SR Moon transits each SR house in roughly one month. Identify the 2–3 months when the " +
-            "SR Moon activates the most loaded SR houses — these are the year's peak moments.\n\n" +
+            "Briefly note which natal houses are 'lit up' by the SR planets. " +
+            "Keep it to the 2–3 strongest overlaps.\n\n" +
             "**Tone**: Visionary and forward-focused. Give the user a map for the year. " +
-            "Be specific and bold — people remember a good SR reading for the entire year.\n\n" +
-            "## Step 5 — Follow-Up Offers\n" +
-            "After the reading, offer to add:\n" +
-            "- **Secondary progressions** — call `ephemeris_progressed_chart` for the slow backdrop " +
-            "(progressed Moon sign/house, upcoming progressed New or Full Moon)\n" +
-            "- **Active transit snapshot** — call `ephemeris_natal_transits` with today's date to show " +
-            "what's already building in their chart heading into the SR year\n" +
-            "- **Second location comparison** — re-run `ephemeris_solar_return` with alternate city coords " +
-            "to compare how the SR Ascendant and house emphasis shifts",
+            "Be specific and bold — people remember a good SR reading.\n\n" +
+            "## Step 5 — Go Deeper (Offer, Don't Dump)\n" +
+            "After the core reading, offer:\n" +
+            "- **Power months** — when does the SR Moon activate the most loaded SR houses?\n" +
+            "- **Location comparison** — re-run the SR for an alternate city to see how the Ascendant shifts\n" +
+            "- **Secondary progressions** — the slow backdrop layered underneath the SR year\n" +
+            "- **Transit snapshot** — what's already building as the SR year begins?",
     },
     // ─────────────────────────────────────────────────────────────────────────
     // 12. Developer API Integration Guide