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

interpreter/src/reading_io.h

@@ -10,14 +10,18 @@
 
 /* Parses deck-engine's `--format json` output (text, null-terminated at
  * text[length]) and fills *out with just enough of a DailyReading for
- * interpret_daily_reading() to work on: out->transits.aspects[]/
- * aspect_count. out->natal and out->spread are left zeroed - nothing
- * here reads them (see significance.c), so there's no reason to parse
- * the rest of the document yet.
+ * interpret_daily_reading() to work on and for reporting sign/house
+ * context around each significant event: out->transits.aspects[]/
+ * aspect_count (used for scoring - see significance.c), and
+ * out->natal.bodies[]/out->transits.bodies[] (sign + house per body,
+ * used only for display). out->natal.ascendant_longitude/houses[] and
+ * out->spread are left zeroed - nothing reads them yet.
  *
  * Returns false on malformed JSON, or if "transits"."aspects" isn't
  * present as an array (an empty array is fine - that's a real "no
- * aspects today" reading, not an error). */
+ * aspects today" reading, not an error). A missing/unrecognized entry
+ * in "natal"."bodies"/"transits"."bodies" is not an error - see
+ * parse_bodies() in reading_io.c. */
 bool reading_load_json(const char *text, size_t length, DailyReading *out);
 
 #endif