nategodd/interp.py

"""NATEGODD interpretation engine.

Hand-written texts for the big three (Sun / Moon / Ascendant in each sign),
plus a keyword-synthesis engine that generates readable prose for every
planet-in-sign, planet-in-house and aspect combination — the same trick the
90s desktop programs used, with a bigger vocabulary.
"""

SIGNS = ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
         "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces"]

PLANET_MEANING = {
    "Sun": ("your core identity and vital force", "identity"),
    "Moon": ("your emotional nature and instinctive needs", "feelings"),
    "Mercury": ("how you think, learn and communicate", "mind"),
    "Venus": ("how you love, relate and what you find beautiful", "affections"),
    "Mars": ("your drive, desire and how you assert yourself", "will"),
    "Jupiter": ("where you expand, trust and find meaning", "growth"),
    "Saturn": ("where you meet limits, discipline and mastery", "structure"),
    "Uranus": ("where you break rules and demand freedom", "individuality"),
    "Neptune": ("where you dream, idealise and dissolve boundaries", "imagination"),
    "Pluto": ("where you transform, purge and confront power", "depths"),
    "Chiron": ("your deepest wound and your gift for healing others", "wound"),
    "Ceres": ("how you nurture and wish to be nurtured", "care"),
    "Pallas": ("your style of wisdom, strategy and pattern-seeing", "strategy"),
    "Juno": ("what you need from committed partnership", "commitment"),
    "Vesta": ("what you devote yourself to with sacred focus", "devotion"),
    "North Node": ("the direction of growth your life keeps pulling you toward", "destiny"),
    "South Node": ("the well-worn gifts and habits you are meant to grow beyond", "past"),
    "Lilith": ("your untamed, uncompromising instinct", "wildness"),
    "Part of Fortune": ("where circumstance tends to reward you", "fortune"),
    "Ascendant": ("the face you show the world and how life approaches you", "persona"),
    "Midheaven": ("your public role, vocation and reputation", "calling"),
}

SIGN_STYLE = {
    "Aries": ("directly, impulsively and with courage", "a pioneer's urgency — first in, fast, and unafraid of a fight",
              "impatience and starting more than you finish"),
    "Taurus": ("steadily, sensually and with great persistence", "a builder's patience — slow to start, impossible to stop",
               "stubbornness and resistance to any change you didn't choose"),
    "Gemini": ("curiously, quickly and through words", "a storyteller's agility — collecting, connecting and re-telling everything",
               "scatter, restlessness and skating on the surface"),
    "Cancer": ("protectively, intuitively and from memory", "a caretaker's tenacity — sideways approaches and a long, long memory",
               "moodiness and retreating into the shell"),
    "Leo": ("dramatically, warmly and from the heart", "a performer's radiance — generous, loyal and impossible to ignore",
            "pride and a hunger for applause"),
    "Virgo": ("precisely, modestly and in service of improvement", "a craftsman's discrimination — nothing escapes your notice",
              "worry, self-criticism and perfectionism"),
    "Libra": ("gracefully, diplomatically and always in relation to others", "an artist's sense of balance — fairness is a physical need",
              "indecision and keeping the peace at your own expense"),
    "Scorpio": ("intensely, privately and all the way to the bottom", "an investigator's penetration — you find what is hidden",
                "suspicion, control and scorched-earth endings"),
    "Sagittarius": ("expansively, honestly and aimed at the horizon", "an explorer's optimism — meaning matters more than comfort",
                    "bluntness, excess and promising more than you deliver"),
    "Capricorn": ("ambitiously, cautiously and for the long game", "a mountain goat's endurance — you climb whatever is in front of you",
                  "pessimism, coldness and working when you should rest"),
    "Aquarius": ("independently, inventively and on principle", "a scientist's detachment — humanity in the abstract, freedom in the particular",
                 "contrariness and aloofness from your own feelings"),
    "Pisces": ("compassionately, imaginatively and without hard edges", "a mystic's permeability — you feel everything in the room",
               "escapism, vagueness and martyrdom"),
}

HOUSE_MEANING = {
    1: "the house of self — your body, appearance and personal initiative",
    2: "the house of resources — money, possessions, talent and self-worth",
    3: "the house of communication — siblings, short journeys, learning and daily talk",
    4: "the house of home — family, roots, ancestry and your private foundation",
    5: "the house of creativity — romance, children, play and self-expression",
    6: "the house of work and health — daily routine, service, craft and the body's upkeep",
    7: "the house of partnership — marriage, close one-to-one bonds and open enemies",
    8: "the house of shared depths — intimacy, other people's money, crisis and regeneration",
    9: "the house of the far horizon — travel, higher learning, philosophy and publishing",
    10: "the house of career — public standing, authority, ambition and reputation",
    11: "the house of community — friends, groups, causes and hopes for the future",
    12: "the house of the hidden — solitude, dreams, self-undoing and transcendence",
}

# ------------------------- hand-written big three -------------------------

SUN_IN_SIGN = {
    "Aries": "You are here to begin things. Aries Sun people run on raw initiative: the idea and the action arrive in the same instant, and waiting is a kind of pain. You are brave, direct and refreshingly free of hidden agendas — what others call recklessness is simply your faith that the door will open if you hit it hard enough. Your growth lies in finishing what you start and discovering that patience is not surrender.",
    "Taurus": "You are here to build things that last. Taurus Sun people have a genius for the physical world — food, music, money, touch, gardens — and a calm that others lean on in a storm. You change slowly and on your own schedule, which is both your greatest strength and the thing that maddens everyone who loves you. Your growth lies in learning that security comes from within, not from what you can hold.",
    "Gemini": "You are here to connect things. Gemini Sun people live through language and curiosity: two of everything, questions before breakfast, and a mind that moves faster than any conversation can. You are the messenger, the translator, the one who makes the room lighter. Your growth lies in depth — staying with one thing, one person, one question long enough to be changed by it.",
    "Cancer": "You are here to care for things. Cancer Sun people feel everything and forget nothing; beneath the shell is the most loyal heart in the zodiac. Home — wherever and whatever that means to you — is not a place but a project, and you protect your people ferociously. Your growth lies in letting yourself be nurtured as fiercely as you nurture, and in leaving the shell even when it might rain.",
    "Leo": "You are here to shine. Leo Sun people carry a warmth that is not performance — it is a genuine wish for everyone in the room to feel more alive. You are generous, dramatic and braver in public than most people are in private. The applause matters more than you admit. Your growth lies in learning that your light does not dim when someone else's is shining.",
    "Virgo": "You are here to perfect things. Virgo Sun people see the flaw, the fix and the better way — instantly and always. Your service is real love in work clothes: you show devotion by improving things for people. The blade you turn on the world you turn hardest on yourself. Your growth lies in accepting that 'good enough' is sometimes the most precise judgement of all.",
    "Libra": "You are here to balance things. Libra Sun people are drawn to beauty, fairness and the space between two people, where you do your finest work. You see every side of every question — a gift in a diplomat, a torment at a menu. Your growth lies in discovering what YOU want when nobody else's preference is available to orbit, and saying it out loud.",
    "Scorpio": "You are here to go beneath things. Scorpio Sun people are the depth psychologists of the zodiac: you sense what is hidden, you keep secrets like a vault, and you love with a totality that frightens lighter souls. You die and are reborn several times in one life. Your growth lies in trusting without testing, and forgiving without forgetting the lesson.",
    "Sagittarius": "You are here to seek the meaning of things. Sagittarius Sun people need a horizon — a journey, a philosophy, a wager, a question big enough to be worth a life. You are honest to a fault (ask anyone who's asked how they look), funny, and allergic to cages. Your growth lies in learning that commitment is not a cage — it is a country you haven't explored yet.",
    "Capricorn": "You are here to master things. Capricorn Sun people are born old and get younger: duty first, the long climb, the dry wit that surprises everyone. You do not want to be given the summit — you want to have earned it. Your growth lies in remembering what the climb was for, and letting the people who love you sit by the fire you built.",
    "Aquarius": "You are here to reinvent things. Aquarius Sun people belong to the future: you see the pattern everyone else is inside of, and you cannot un-see it. Friendship is your religion, principle your compass, and being ordinary the only thing you truly fear. Your growth lies in coming down from the observatory — letting one person, up close, matter as much as humanity in the abstract.",
    "Pisces": "You are here to dissolve the walls between things. Pisces Sun people feel the whole ocean: other people's moods, the mood of the age, music no one else hears yet. You are the zodiac's artist and mystic, compassionate past the point of self-interest. Your growth lies in building a container for the ocean — boundaries, routines, a raft — so the tide carries you instead of sweeping you away.",
}

MOON_IN_SIGN = {
    "Aries": "Emotionally you are a flash fire — quick to anger, quick to laugh, incapable of sulking for long. You need action when you're upset; sitting with a feeling feels like drowning in slow motion. You are safest with people who let you flare without flinching.",
    "Taurus": "Emotionally you are bedrock. You need comfort you can touch: good food, familiar rooms, a body beside you, a predictable rhythm. It takes a great deal to upset you and a great deal more to change your mind afterwards. The Moon is exalted here — feelings, once given, do not waver.",
    "Gemini": "Emotionally you need to talk it out — a feeling isn't real until it's been put into words, preferably with a sympathetic listener and several tangents. Restlessness is how sadness shows up in you. You are safest with people who find your changeability charming rather than alarming.",
    "Cancer": "Emotionally you are at full strength — the Moon rules Cancer, and you feel in tides: high, low, and never negotiable. Memory and mood are fused; an old song can undo you. You need a shell — a home, a person, a ritual — that is unconditionally yours. Your care for others is oceanic.",
    "Leo": "Emotionally you need to be seen. Warm, loyal and dramatic, you give affection like sunlight and wilt in rooms where you're ignored. Wounded pride hurts you more than almost anything real. You are safest with people who applaud first and critique later — or never.",
    "Virgo": "Emotionally you cope by being useful. Anxiety goes into lists, care goes into acts of service, and love is shown by remembering exactly how everyone takes their tea. You need order when you're overwhelmed. Let people love the unedited version of you, too.",
    "Libra": "Emotionally you need harmony the way others need air — conflict in the room registers in your body. You reach instinctively for the balancing word, the fair compromise, the beautiful gesture. Your work is noticing your own feelings before you've adjusted them to suit the company.",
    "Scorpio": "Emotionally you are all-or-nothing in a sealed vault. You feel more intensely than anyone around you and show less of it. Trust is everything and is never fully finished being tested. When you finally open the vault, your loyalty is absolute — and so is your memory of betrayal.",
    "Sagittarius": "Emotionally you need open sky. Heaviness makes you reach for the passport, the joke, the philosophical reframe — anything but the swamp. Your optimism is genuine and medicinal to others. Just notice when the horizon is a direction and when it's an exit.",
    "Capricorn": "Emotionally you are self-contained and self-controlled — feelings are handled, privately, on a schedule. You show love through reliability: being there, paying for it, fixing it. Your work is letting someone see you before the feeling has been fully processed and filed.",
    "Aquarius": "Emotionally you observe yourself from a slight distance — feelings are interesting data, best examined with a friend, ideally about something other than the two of you. You need freedom inside closeness. Your work is staying in the room when the feeling is happening, not after.",
    "Pisces": "Emotionally you are a tidal instrument — you register everyone's weather and sometimes lose track of which feelings are yours. Music, water, sleep and solitude restore you. Your compassion has no floor. Your work is a gentle boundary: you can feel with people without drowning for them.",
}

RISING_IN_SIGN = {
    "Aries": "You come across as direct, energetic and slightly ahead of everyone else — first through the door, first to speak. Life meets you as a series of starts, dares and fresh campaigns. People underestimate your sensitivity because your armour looks so good.",
    "Taurus": "You come across as calm, solid and unhurried — a settling presence people instinctively trust. Life meets you slowly and materially: things build, accumulate, take root. People underestimate how immovable you become once you've decided.",
    "Gemini": "You come across as bright, quick and endlessly conversational — the one who knows a little about everything and someone in every room. Life meets you as a stream of messages, errands and interesting strangers. People underestimate the serious mind behind the banter.",
    "Cancer": "You come across as gentle, receptive and a little guarded — people want to confide in you within minutes. Life meets you through belonging: family, home and the question of who is 'yours'. People underestimate the crab's grip beneath the softness.",
    "Leo": "You come across as warm, confident and impossible to overlook — you have presence before you have said a word. Life meets you as a stage with your name somewhere on the bill. People underestimate how much courage it costs to keep the show running.",
    "Virgo": "You come across as composed, attentive and precise — the person who noticed, and quietly fixed it. Life meets you as work to be done well. People underestimate the dry wit and the depth of care hiding inside the competence.",
    "Libra": "You come across as charming, fair and beautifully put together — people relax around you and can't quite say why. Life meets you through others: partners, audiences, negotiations. People underestimate the steel it takes to keep everything so pleasant.",
    "Scorpio": "You come across as magnetic, contained and faintly unknowable — people feel seen by you and slightly exposed. Life meets you in intensities: all-in bonds, deep endings, real stakes. People underestimate how much you've survived, because you never lead with it.",
    "Sagittarius": "You come across as open, funny and larger than the room — the accent of somewhere else, even at home. Life meets you as a journey with luggage optional. People underestimate the philosopher under the punchlines.",
    "Capricorn": "You come across as capable, reserved and older than your years — authority attaches itself to you unasked. Life meets you as a mountain, and you climb it. People underestimate the loyalty and humour beneath the executive surface.",
    "Aquarius": "You come across as friendly, original and one degree removed — of the group and somehow watching it too. Life meets you as a series of systems to question. People underestimate how much you care, because you care in principles rather than displays.",
    "Pisces": "You come across as soft-edged, kind and a little otherworldly — people project their favourite story onto you. Life meets you as atmosphere: moods, coincidences, callings. People underestimate the tidal strength with which you eventually go where you're going.",
}

# ------------------------- synthesis -------------------------


def planet_in_sign(planet, sign):
    if planet == "Sun":
        return SUN_IN_SIGN[sign]
    if planet == "Moon":
        return MOON_IN_SIGN[sign]
    if planet == "Ascendant":
        return RISING_IN_SIGN[sign]
    if planet not in PLANET_MEANING:
        return ""
    what, _ = PLANET_MEANING[planet]
    style, gift, shadow = SIGN_STYLE[sign]
    return (f"{planet} in {sign} colours {what}: it operates {style}. "
            f"At its best this gives {gift}. "
            f"The shadow side to watch is {shadow}.")


def planet_in_house(planet, house):
    if planet not in PLANET_MEANING or house not in HOUSE_MEANING:
        return ""
    what, _ = PLANET_MEANING[planet]
    return (f"{planet} falls in {HOUSE_MEANING[house]}. "
            f"This is the arena of life where {what} plays out most visibly — "
            f"expect the themes of this house to keep finding you.")


ASPECT_DYNAMICS = {
    "Conjunction": "are fused — they act as one, each permanently coloured by the other",
    "Opposition": "face each other across a divide — life keeps asking you to balance them, often through other people",
    "Trine": "flow together effortlessly — a genuine talent, so natural you may undervalue it",
    "Square": "grind against each other — a lifelong friction that, worked honestly, becomes your engine",
    "Sextile": "cooperate when invited — an opportunity that rewards a little deliberate effort",
    "Quincunx": "speak different languages entirely — they require constant, slightly awkward adjustment",
    "Semisextile": "sit uneasily side by side — a subtle irritant and a subtle resource",
    "Semisquare": "chafe in the background — minor but persistent friction",
    "Sesquiquadrate": "provoke each other at odd moments — friction that surfaces when you least expect it",
    "Quintile": "combine with unusual creativity — a signature talent with a personal twist",
    "Biquintile": "combine with subtle artistry — a refined, almost private gift",
}


def aspect_text(a, b, aspect, orb, applying=None):
    da = PLANET_MEANING.get(a, (a.lower(), ""))[0]
    db = PLANET_MEANING.get(b, (b.lower(), ""))[0]
    dyn = ASPECT_DYNAMICS.get(aspect, "interact")
    tight = "This is one of the defining aspects of your chart. " if orb <= 1.5 else ""
    app = ""
    if applying is True:
        app = " (applying — its influence strengthens through life)"
    elif applying is False:
        app = " (separating — an influence you were born already knowing)"
    return (f"{a} {aspect.lower()} {b} (orb {orb}°{app}): "
            f"{da.capitalize()} and {db} {dyn}. {tight}").strip()


BALANCE_TEXT = {
    "Fire": "spirit, enthusiasm and the urge to act",
    "Earth": "practicality, patience and the physical world",
    "Air": "ideas, language and social connection",
    "Water": "feeling, intuition and emotional bonds",
    "Cardinal": "initiating — you start things",
    "Fixed": "sustaining — you keep things going",
    "Mutable": "adapting — you adjust and redistribute",
}


def balance_summary(balances):
    lines = []
    for group_name, group in (("elements", balances["elements"]), ("modalities", balances["modalities"])):
        items = sorted(group.items(), key=lambda kv: -kv[1])
        hi, hi_v = items[0]
        lo, lo_v = items[-1]
        if hi_v >= 2 * max(1, lo_v):
            lines.append(f"Your chart is strongly weighted toward {hi} ({BALANCE_TEXT[hi]}).")
        if lo_v == 0:
            lines.append(f"You have no planets in {lo} — {BALANCE_TEXT[lo]} is the language you must consciously learn, and often the one you seek in partners.")
        elif lo_v <= 1:
            lines.append(f"{lo} is scarce in your chart — {BALANCE_TEXT[lo]} takes deliberate effort.")
    return lines


def build_interpretation(chart):
    """Assemble the full report from a compute_chart() result."""
    by_name = {b["name"]: b for b in chart["bodies"]}
    asc_sign = chart["angles"][0]["position"]["sign"]
    sections = []

    big3 = []
    if "Sun" in by_name:
        s = by_name["Sun"]["position"]["sign"]
        big3.append({"title": f"Sun in {s}", "body": SUN_IN_SIGN[s]})
    if "Moon" in by_name:
        s = by_name["Moon"]["position"]["sign"]
        big3.append({"title": f"Moon in {s}", "body": MOON_IN_SIGN[s]})
    if not chart.get("time_unknown"):
        big3.append({"title": f"{asc_sign} Rising", "body": RISING_IN_SIGN[asc_sign]})
    sections.append({"heading": "The Big Three", "items": big3})

    items = []
    for b in chart["bodies"]:
        name = b["name"]
        if name in ("Sun", "Moon", "South Node", "Part of Fortune"):
            continue
        sign = b["position"]["sign"]
        txt = planet_in_sign(name, sign)
        if not txt:
            continue
        extra = ""
        if b["retrograde"]:
            extra += " Retrograde at your birth: this function turns inward — it matures late, privately, and on its own terms."
        if b["dignities"]:
            dg = ", ".join(b["dignities"])
            extra += f" ({dg} — this placement carries special weight.)"
        items.append({"title": f"{name} in {sign}", "body": txt + extra})
    sections.append({"heading": "Planets in Signs", "items": items})

    if not chart.get("time_unknown"):
        items = []
        for b in chart["bodies"]:
            txt = planet_in_house(b["name"], b["house"])
            if txt:
                items.append({"title": f'{b["name"]} in House {b["house"]}', "body": txt})
        sections.append({"heading": "Planets in Houses", "items": items})

    items = []
    for a in chart["aspects"]:
        if not a["major"] and a["orb"] > 1.5:
            continue
        items.append({"title": f'{a["a"]} {a["glyph"]} {a["b"]}',
                      "body": aspect_text(a["a"], a["b"], a["aspect"], a["orb"], a["applying"])})
    sections.append({"heading": "Aspects", "items": items[:40]})

    bal = balance_summary(chart["balances"])
    extra_bits = []
    if chart.get("moon_phase"):
        mp = chart["moon_phase"]
        extra_bits.append(f'You were born under a {mp["name"]} ({mp["illumination"]}% illuminated).')
    extra_bits.append("This is a day chart — the Sun was above the horizon; solar themes (identity, visibility, purpose) lead."
                      if chart["is_day_chart"] else
                      "This is a night chart — the Sun was below the horizon; lunar themes (instinct, memory, belonging) lead.")
    sections.append({"heading": "Chart Signature",
                     "items": [{"title": "Balances", "body": " ".join(bal) or "Your chart is unusually evenly balanced across elements and modalities — you can meet life in whatever language it speaks."},
                               {"title": "Sect & Moon Phase", "body": " ".join(extra_bits)}]})
    return sections