backup: 2026-06-17 07:36

trmnschedule.org

@@ -0,0 +1,66 @@
+:PROPERTIES:
+:ID: ff8aa6b7-61ff-444c-9301-c0b666b0b573
+:END:
+
+#+title: trmn/schedule
+#+filetags: :project: :knowledge: :schedule:
+
+:PROPERTIES:
+:ID: trmn-schedule
+:END:
+
+#+title: trmn/schedule
+#+filetags: :project: :knowledge: :schedule:
+
+** Architecture
+~schedule.js~ is a standalone ES module that exports:
+- ~generateDaySchedule(today, traits, dayEvents, currentDay, masterSeed)~ → ~ScheduleEntry[]~
+- ~SCENES~ — plain object catalog of all ~68 scenes
+- ~slotToTime(slot)~ → ~"HH:MM"~ string (slot 0 = 06:00)
+- ~SLOTS~ (96), ~SLOT_MIN~ (15)
+
+~ScheduleEntry~: ~{ slot, duration, sceneId, location, label }~. Array is sorted by slot, non-overlapping, always covers all 96 slots with no gaps (builder fills remainder with ~sleep~).
+
+RNG isolation: schedule uses ~makeRng(masterSeed, currentDay + 50000)~. Offset of 50,000 clears the life sim's 0–36,500 range — no interference with protagonist daily streams.
+
+~window.__life~ exposes ~{ ..., schedule }~ alongside ~buf~, ~eventLog~, ~people~.
+
+** Slot Layout
+#+begin_example
+Slots  0–11   06:00–09:00   morning routine      (12 slots)
+Slots 12–23   09:00–12:00   early daytime        (12 slots)
+Slots 24–43   12:00–17:00   afternoon            (20 slots)
+Slots 44–55   17:00–20:00   early evening        (12 slots)
+Slots 56–63   20:00–22:00   late evening          (8 slots)
+Slots 64–95   22:00–06:00   sleep                (32 slots)
+#+end_example
+
+** Life Stage Detection
+~detectLifeStage(today, age)~ → one of 10 tags, checked in priority order:
+~very_sick~ (sick + health<25) → ~sick~ → ~toddler~ (age<5) → ~kindergarten~ (eduStage=1) → ~school~ (eduStage=2/3) → ~college~ (inCollege) → ~retired~ → ~worker~ (employed) → ~unemployed~ (age≥16) → ~child~
+
+** Forced Events
+Events in ~dayEvents~ (from ~eventLog.get(currentDay)~) that override normal blocks:
+| Event ID | Override |
+|---|---|
+| ~illness_acute~ | daytime → rest_in_bed; skip work/school |
+| ~serious_accident~ / ~injury_serious~ | afternoon → emergency_room |
+| ~first_child~ / ~subsequent_child~ | daytime → hospital_stay |
+| ~marry~ | afternoon → wedding_ceremony; evening → wedding_reception |
+| ~family_member_death~ (attended=true) | afternoon → funeral_ceremony + wake |
+| ~move_city~ | full day → moving_boxes |
+| ~premature_death~ | minimal day, idle |
+
+** Gotchas
+- ~jobCategory~ is NOT in the packed ~Float32Array~ buffer (not a field in ~F~). Schedule derives a stable per-character type from ~makeRng(masterSeed ^ 0x5A5A5A5A, 0)~. This is deterministic per character but may not match what was rolled in the life sim.
+- Young-child stages (~toddler~, ~kindergarten~, ~school~, ~child~) must be branched BEFORE adult defaults in morning and evening blocks. The ~isYoungChild~ flag gates: no ~make_breakfast~, no ~cook_dinner~, no ~morning_coffee~, no ~morning_exercise~. The adult fallthrough path always ran these — easy to regress.
+- ~go_to_park_with_parents~ is from the CHILD's perspective; ~hasYoungChildren~ is from the PARENT's perspective. They are mutually exclusive: ~hasYoungChildren = numChildren > 0 && age < 40~.
+- The schedule builder (~makeBuilder~) clamps at slot 96: ~push~ is a no-op once cursor ≥ SLOTS. ~fill(sceneId, toSlot)~ is safe to call even if cursor is already past ~toSlot~.
+
+** Debug Tool
+~schedule-debug.mjs~ — CLI tool, ~nix run .#schedule~
+- No args: random seed + random day from character's living years, full output
+- Prints seed, day, age, full state, traits, events, then schedule table
+- All state fields overridable: ~--seed~, ~--day~, ~--age~, ~--health~, ~--sick~, ~--employed~, ~--retired~, ~--married~, ~--children~, ~--friends~, ~--job-tier~, ~--loneliness~
+- ~--event <id>~ injects a forced event (repeatable); injected events are labelled ~(injected)~ in output
+- ~--help~ prints usage