Report sign/house in significant transits; back up user.properties outside dist/

docs/architecture.md

@@ -36,8 +36,11 @@ know before changing the engine. This document is the visual overview.
 - **`dist/`** is generated by the single root `Makefile`: the
   `deck-engine` and `interpreter-cli` binaries, a copy of the card art
   under `img/`, a copy of the translation files under `i18n/`,
-  `run-engine.sh`/`run-interpreter.sh`, and a `user.properties` template
-  that's seeded once and never overwritten by later builds.
+  `run-engine.sh`/`run-interpreter.sh`, and `user.properties`. Since
+  `dist/` itself is disposable, `user.properties` also gets backed up to
+  `engine/scripts/user.properties.local` (gitignored) once it's filled
+  in, and restored from there if `dist/` is ever wiped — see
+  `CLAUDE.md`'s "Build & run".
 - **The Pebble watchapp does not exist yet.** When it's built, it will
   call `reading_generate()` directly and walk the returned struct to lay
   out its own screens — it has no reason to touch `reading_print_*`.

docs/input-output-format.md

@@ -55,11 +55,15 @@ use:
   ```
 
   The file is seeded once from `engine/scripts/user.properties.template`
-  with placeholder values (`YOUR_BIRTH_DATE_HERE`, etc.) and is **never
-  overwritten by later builds**. `run-engine.sh` checks every birth field
-  for an empty value or a leftover `YOUR_` placeholder and refuses to run
-  with a clear error until the file is filled in; `lang` has no such
-  check since it always has a usable default (`en`).
+  with placeholder values (`YOUR_BIRTH_DATE_HERE`, etc.). `run-engine.sh`
+  checks every birth field for an empty value or a leftover `YOUR_`
+  placeholder and refuses to run with a clear error until the file is
+  filled in; `lang` has no such check since it always has a usable
+  default (`en`). Since `dist/` itself can be wiped (`make clean`, or
+  deleting the directory), the build also keeps a durable backup at
+  `engine/scripts/user.properties.local` (gitignored) once the file
+  looks filled in, and restores from it if `dist/user.properties` is
+  ever missing — see `CLAUDE.md`'s "Build & run".
 - The optional second argument overrides `lang=` for a single run without
   editing the file, e.g. `dist/run-engine.sh html de`.
 - `dist/run-interpreter.sh` (no arguments) is the equivalent wrapper for
@@ -236,22 +240,26 @@ dist/run-interpreter.sh
 ```
 
 - **Input**: a file path argument, or stdin if no argument (or `-`) is
-  given. Only `"transits"."aspects"` is read — `natal` and `spread` may
-  be present (and are ignored) or omitted entirely, except that
-  `"transits"."aspects"` itself must be present (an empty array is valid
-  and means "no notable transits today"; a missing key is treated as
-  invalid input).
+  given. `"transits"."aspects"` is required (an empty array is valid and
+  means "no notable transits today"; a missing key is treated as invalid
+  input) and drives scoring. `"natal"."bodies"`/`"transits"."bodies"` are
+  read too, for the sign/house context printed alongside each event below
+  (not for scoring) — an entry naming an unrecognized body, or a missing
+  `house`, is silently skipped rather than failing the load (see
+  `parse_bodies()` in `reading_io.c`); `spread` is always ignored.
 - **Output**: a plain-text report — the day's overall significance level
   (`Quiet`/`Notable`/`Significant`/`Major`), a "worth a deeper Celtic
   Cross look" line on `Major` days only, and up to 5 of today's aspects
-  ranked by score:
+  ranked by score, each naming the sign and natal house the transiting
+  planet currently occupies and the sign and house of the natal planet
+  it's aspecting:
 
   ```
   Day significance: Significant
   (a major transit today - worth a deeper Celtic Cross look)
 
   Top 3 significant transits:
-    1. Transiting Saturn Square natal Sun (orb 0.5°, score 8.10)
-    2. Transiting Pluto Opposition natal Moon (orb 0.2°, score 7.92)
-    3. Transiting Jupiter Trine natal Venus (orb 2.1°, score 3.40)
+    1. Transiting Saturn in Aries (house 2) Square natal Sun in Taurus (house 3) (orb 0.5°, score 8.10)
+    2. Transiting Pluto in Aquarius (house 12) Opposition natal Moon in Capricorn (house 11) (orb 0.2°, score 7.92)
+    3. Transiting Jupiter in Leo (house 5) Trine natal Venus in Aries (house 2) (orb 2.1°, score 3.40)
   ```