Add narrative text and a day-significance rank to the interpreter

Each of the day's top significant transits now gets a short sentence
describing what it classically means and which area of life its house
governs, condensed from Sepharial's Transits and Planetary Periods
(1920, public domain) plus a small table of traditional house
significations. The day-level line also shows its rank out of the 4
defined levels, e.g. "Notable (2/4)". Docs (CLAUDE.md, README,
docs/input-output-format.md, docs/reading.md) updated to match,
including a full worked example in docs/reading.md.

docs/reading.md

@@ -75,26 +75,92 @@ spread — the same source most modern tarot decks trace back to.
 Not every day is equally eventful astrologically. A separate,
 optional step can look at today's aspects (part 2, above) and works
 out an overall **significance level** for the day — Quiet, Notable,
-Significant, or Major — based on which planets are involved, how exact
-the angle is, and whether it touches your Sun or Moon (the two most
-personally weighted points in a chart). On a genuinely Major day, it
-also calls out the single most important thing happening, as a hint
-that it's worth paying closer attention to your tarot spread that day
-rather than treating it as routine. Quiet days still get a full
+Significant, or Major, shown together with its rank out of those four
+(for example "Notable (2/4)") — based on which planets are involved,
+how exact the angle is, and whether it touches your Sun or Moon (the
+two most personally weighted points in a chart). On a genuinely Major
+day, it also calls out the single most important thing happening, as a
+hint that it's worth paying closer attention to your tarot spread that
+day rather than treating it as routine. Quiet days still get a full
 reading — this step only adds a "pay attention today" flag, it never
 removes anything.
 
+For each of the handful of events that make up today's score, you also
+get a plain sentence about what it classically means and *which area
+of your life* it's playing out in — drawn from the house it falls in
+(see "Today's sky", above). For example, a tense aspect from Saturn
+landing in your 6th house reads as a day for your daily work and
+routine to feel a bit stuck, not just "Saturn is doing something."
+That wording is condensed from a public-domain 1920 astrology book
+(Sepharial's *Transits and Planetary Periods*), the same way the tarot
+card meanings are condensed from Waite's 1911 book.
+
 ## What a day's reading actually gives you
 
 Put together, one day's reading contains: your natal chart (for
 reference), today's sky and how it's speaking to your chart, how
-significant today is overall, and your 10-card Celtic Cross spread for
-the day. Right now these sit side by side — the astrology tells you
-*how eventful* today is and *where* to pay attention, and the tarot
-spread gives you the actual guidance to sit with. They don't yet get
-woven into a single narrative (e.g. a spread explained *in light of*
-today's significant transit) — that combined storytelling is the next
-piece to build, not something you get today.
+significant today is overall (with a plain-language note on each of the
+main events driving that), and your 10-card Celtic Cross spread for the
+day. Right now these sit side by side — the astrology tells you *how
+eventful* today is and *where* to pay attention, and the tarot spread
+gives you the actual guidance to sit with. They don't yet get woven
+into a single narrative (e.g. a spread explained *in light of* today's
+significant transit) — that combined storytelling is the next piece to
+build, not something you get today.
 
 *(This page, like that piece, is still a work in progress — expect it
 to grow as the reading itself does.)*
+
+## A worked example
+
+Here's what an actual day's reading looks like end to end, for someone
+born 14 March 1988 in Berlin, checking their reading on 5 July 2026.
+
+**Natal chart (excerpt).** Sun in Pisces, Moon in Aquarius, Ascendant in
+Sagittarius.
+
+**Today's sky (excerpt).** Moon phase: Waning Gibbous. Several planets
+are forming aspects back to the natal chart above — see below for which
+ones actually matter.
+
+**How big is today.**
+
+```
+Day significance: Major (4/4)
+(a major transit today - worth a deeper Celtic Cross look)
+
+Top 5 significant transits:
+  1. Transiting Pluto in Aquarius (house 3) Conjunction natal Moon in Aquarius (house 3) (orb 2.9°, score 9.60)
+     In matters of communication, siblings, and everyday learning (house 3). Brings deep, often
+     hidden transformation - the surfacing or dismantling of something that has outgrown its old form.
+  2. Transiting Neptune in Aries (house 5) Sextile natal Moon in Aquarius (house 3) (orb 2.5°, score 9.25)
+     In matters of romance, creativity, and children (house 5). Brings a state of chaos and confusion -
+     an involved, uncertain condition of affairs, with plots, subtlety, or unseen influences at work.
+  3. Transiting Uranus in Gemini (house 7) Trine natal Moon in Aquarius (house 3) (orb 2.0°, score 8.96)
+     In matters of partnerships and close relationships (house 7). Brings separations, estrangements,
+     sudden dislocations and violent upsets. Success through official or civic channels, and beneficial
+     changes or appointments, are possible.
+```
+
+In plain terms: today is about as big as this reading gets (Major,
+4 out of 4), and the story is squarely about the Moon — a slow-moving
+Pluto sitting right on top of it, a chaotic Neptune touching it gently
+from the 5th house, and a disruptive-but-possibly-lucky Uranus trine
+from the 7th. Communication, romance, and relationships are all
+quietly under pressure at once.
+
+**Tarot spread (excerpt).** Drawn independently, using today's date:
+
+- *The Present* — The Emperor, reversed: immaturity or a loss of
+  authority, rather than confident structure.
+- *The Challenge* — The Devil: force, ravage, an obstacle that isn't
+  easily reasoned with.
+- *The Near Future* — The World, reversed: stagnation, things staying
+  fixed in place rather than resolving.
+
+Read side by side, the astrology and the tarot happen to rhyme here —
+both point toward something that wants to shift (Pluto's "hidden
+transformation," The Devil's "force") running into something that
+feels stuck (a reversed World, an afflicted Moon) — but that's the
+reader's own synthesis for now, not something the app does for you (see
+above).