org_web/docs/hidden-soul-bible.md

# Hidden Soul Bible

## 1. Creative Pillars

The hidden layer should feel like an emotional internet artifact: a personal site that has been lived in, repaired, renamed, backed up, forgotten, and returned to. It should reward attention without demanding completion.

Primary emotional tones:

- Cozy familial: kitchen lights, rice, mugs, family notes, practical tenderness.
- Funny and self-aware: fake system warnings, old-web jokes, suspicious biscuit tins, web development folklore.
- Reflective melancholy: unfinished letters, old usernames, returning to changed rooms.
- Gentle mystery: Morrow, Nettle, Luma, Etta, Aunt Ma, Nadir, the radio, the train platform.
- Internet nostalgia: guestbooks, counters, dial-up usernames, under construction language, source-code relics.

## 2. Recurring Cast

- Morrow: a quiet figure tied to trains, platforms, lanterns, and unfinished apologies. Morrow represents return, hesitation, and the comfort of being expected.
- Nettle: the archivist/moderator figure. Files impossible feelings under practical labels. Carries a clipboard and treats emotional continuity as infrastructure.
- Luma: a lamp-associated presence who hums original tiny songs and notices margins. Luma represents small courage.
- Etta: writer of the "Do Not Open" letter. Represents vulnerability hidden behind instructions and labels.
- Aunt Ma: warm, funny, practical family presence. Connected to recipes, suspicious biscuit tins, and household wisdom.
- Nadir: backup-minded family historian. Explains technical care through domestic metaphors.
- Old Guest 14 / guest_000 / sunnydialup88: old-web guestbook presences who blur past visitors, usernames, and memory.

## 3. Symbolic Objects

- Lamp: patience, late-night comfort, permission to rest.
- Mug: continuity, small damage kept because it belongs.
- Return ticket: coming back without needing to explain where from.
- Radio: almost-heard family memory, voice messages, weather, original hums.
- Pressed flower / marigold: seasonal return, promises that do not announce themselves.
- Biscuit tin: running joke; allegedly contains tools, feelings, or neither.
- Train platform: delay, return, growing older, being expected.
- Cupboard: hidden terminal, family storage, recursive domestic mystery.

## 4. Implemented Global Systems

### Footer Notes

- Trigger: every page load with a footer.
- Content: rotates through 102 first-layer messages plus new second-layer continuity.
- Frequency: always visible but subtle.
- Lore: the footer is the house threshold.
- UX: muted centered text; should feel like a small afterthought.

### Homepage Greetings

- Trigger: homepage load.
- Content: randomized greeting; repeat visitors receive memory-aware copy.
- Frequency: always on homepage.
- Lore: the site recognizes returning visitors locally through `localStorage`.

### Hover Whispers

- Trigger: some paragraphs and headings gain tiny hover/click notes.
- Content: short poems, quotes, and second-layer hidden memories.
- Frequency: deterministic per page; not every paragraph.
- UX: dotted question marks and heading hover captions.

### Corner Object

- Trigger: click the small fixed corner symbol.
- Sequence: five escalating messages, then seven clicks opens `/play/left-behind.html`.
- Lore: a loose panel in the page.

### Keepsake Constellation

- Trigger: click the five tiny bottom keepsakes: lamp, mug, ticket, radio, flower.
- Payoff: after all are clicked, the site suggests searching `radio under stairs`.
- Frequency: always present, low opacity.
- Lore: collecting ordinary objects aligns the hidden family memory.

### Weather Window

- Trigger: after at least three visits, a subtle `window` button appears. User click requests browser location.
- Content: weather-aware line through Open-Meteo if permission/network works; indoor-weather fallback otherwise.
- Frequency: repeat visitors only.
- UX: no automatic permission prompt.

### Visit Milestones

- Trigger: visit counts 2, 5, 9, 17, 31, 64.
- Content: progressively warmer messages about being remembered.
- Lore: the site stores visits locally, not identities.

### Page Revisit Memory

- Trigger: 3rd, 7th, and 12th visit to the same path.
- Content: page-specific return messages.
- Lore: individual rooms recognize repeated footsteps.

### Seasonal Content

- Trigger: low-probability seasonal toast on page load.
- Content: winter blanket, spring pressed flower, summer fan/window, autumn leaf-links.
- Frequency: 18% chance.

### Date Events

- Site birthday: May 9. Message about imaginary candles.
- Visitor anniversary: same month/day as first stored visit.
- Minute thirteen: radio throat-clearing message.

### Night Messages

- Trigger: 22:00-04:59 local browser time.
- Content: gentle late-night comfort.
- Visual: soft bottom glow.

### Search Secrets

- `morrow`: lantern/lake/apology.
- `nettle`: clipboard/cupboard/semicolon.
- `home`: warm window/spare key.
- `kitchen light`: opens `/play/kitchen-light.html`.
- `radio under stairs`: opens `/play/radio-room.html`.
- `guestbook 1999`: opens `/play/guestbook-1999.html`.
- `do not open`: opens `/play/do-not-open.html`.
- `cassette`: opens `/play/cassette-log.html`.
- `return ticket`: opens `/play/train-platform.html`.
- `unfinished letter`: opens `/play/forgotten-draft.html`.
- `burnt sugar`: opens `/play/corrupted-recipe.html`.
- `cupboard`: opens `/play/terminal-cupboard.html`.
- `patience`: opens `/play/patience-game.html`.
- `marigold`, `luma`, `nadir`: lore toasts.

### Typed Phrase Secrets

- `remember`: continuity toast.
- `dream`: opens Dream Corridor.
- `leave the light on`: opens Kitchen Light.
- `oldweb`: old layout joke.
- `ma`: biscuit tin joke.
- `luma`: plays a tiny original tone sequence.

### Rare Events

- First layer: rare page breeze and biscuit event.
- Second layer:
  - 0.6% rare homepage old-web takeover.
  - 0.2% cassette asks permission.
  - 0.4% recurring dream line.
  - 0.8% cryptic comforting warning.
- Rule: rare events should delight, not block navigation.

### Patience Rewards

- Trigger: 90 seconds of inactivity after repeat visits.
- Content: quiet no-achievement reward.
- Lore: patience and kindness count even when not announced.

### Source Relics and Alt Text

- Trigger: DOM load.
- Behavior: adds a source-code comment and fills empty image alt text with scrapbook-like hidden descriptions.
- Purpose: secrets inside source and accessibility-friendly hidden storytelling.

### Audio

- Trigger: user action only, never autoplay.
- Content: short original Web Audio tone sequence associated with Luma/cassettes.
- Note: no copyrighted lyrics or melodies.

## 5. Implemented Secret Pages

### `/play/left-behind.html`

- Trigger: seven clicks on corner object.
- Tone: familial, emotional.
- Lore: blue bowl, soup memory, Morrow at 2:13.

### `/play/dream-corridor.html`

- Trigger: logo taps or typed `dream`.
- Tone: surreal, safe.
- Lore: three shy doors, Nettle margin note.

### `/play/kitchen-light.html`

- Trigger: search `kitchen light` or phrase `leave the light on`.
- Tone: late-night comfort.
- Lore: rice in pot, towel on chair, light asks no questions.

### `/play/radio-room.html`

- Trigger: search `radio under stairs`; keepsake constellation hints it.
- Tone: nostalgic audio memory.
- Lore: Nadir backups, Luma humming, no autoplay manners.

### `/play/guestbook-1999.html`

- Trigger: search `guestbook 1999`.
- Tone: old-web funny/melancholy.
- Lore: fake users are recurring ghosts of the old internet.

### `/play/do-not-open.html`

- Trigger: search `do not open`.
- Tone: emotionally meaningful warning.
- Lore: Etta wanted to be found carefully.

### `/play/cassette-log.html`

- Trigger: search `cassette`.
- Tone: archive/audio.
- Interaction: buttons reveal cassette transcript toasts and play original tones.

### `/play/train-platform.html`

- Trigger: search `return ticket`.
- Tone: patient return.
- Lore: platform 3, Morrow, destinations as feelings.

### `/play/forgotten-draft.html`

- Trigger: search `unfinished letter`.
- Tone: unsent vulnerability.
- Lore: website as a way to recover rooms in pieces.

### `/play/corrupted-recipe.html`

- Trigger: search `burnt sugar`.
- Tone: funny family warmth.
- Lore: recipe corrupted into folklore.

### `/play/terminal-cupboard.html`

- Trigger: search `cupboard`.
- Tone: hidden terminal, domestic mystery.
- Commands: `help`, `listen`, `inventory`, `tea`, `open`, `remember`, `exit`.

### `/play/patience-game.html`

- Trigger: search `patience`.
- Tone: quiet game.
- Interaction: wait. Text changes at 30, 90, and 180 seconds.

## 6. Emotional Tone Categories

- Comfort: Kitchen Light, night messages, visitor milestones, patience rewards.
- Humor: biscuit tin, fake users, old-web jokes, fake errors.
- Melancholy: Forgotten Draft, train platform, cassettes, old usernames.
- Mystery: Dream Corridor, radio, cupboard, rare dreams.
- Familial warmth: corrupted recipe, Aunt Ma, Nadir, blue bowl.
- Meta/web: source relics, under construction takeover, cache warnings.

## 7. Page/Section Categories

- Global: footer notes, toasts, hover whispers, keepsakes, weather window, source comments.
- Homepage: greetings, rare old-web takeover, logo taps.
- Search/nav: keyword portals.
- Play wing: secret rooms and tiny games.
- Comments: fake guestbook line when comments exist.
- Images/source: hidden alt text and source-code comment.

## 8. UI/UX Notes

- Hidden UI stays low opacity until hovered/focused.
- No feature should obscure reading for long.
- Audio requires explicit action.
- Weather requests require explicit click and have graceful fallback.
- Secret pages are buildable but marked `#+HIDDEN_PAGE: t` so they do not appear in index pages.
- Rewards are intentionally non-competitive; no public checklist.

## 9. Audio/Visual Suggestions

- Add tiny original ambient loops only after explicit button press.
- Use cassette hiss, lamp hum, rain-on-window synthesis, and soft train-platform chimes.
- Consider small generated bitmap textures: paper receipt, cassette label, pressed flower, old guestbook banner.
- Avoid horror stingers; even corrupted pages should be emotionally safe.

## 10. Long-Term Evolution

- Monthly train destination changes.
- Seasonal recipe variants.
- Yearly visitor anniversary letters.
- A slow Luma arc where the lamp becomes less shy after enough patient moments.
- Nettle's filing labels can become warmer over time.
- Morrow's return ticket can gain stamps after visits to secret rooms.
- Guestbook users can post new fake entries on real calendar dates.

## 11. Future Expansion Ideas

- Add a real local-only guestbook draft pad that stores messages in `localStorage`.
- Add a hidden "attic" page unlocked after visiting all secret rooms.
- Add generated cassette-label images for each log.
- Add a no-score cooking memory game using family recipe fragments.
- Add an RSS-feed-only hidden note.
- Add source-map comments or HTML comments with letter fragments.
- Add a "kindness route" where closing pages gently or waiting unlocks softer endings.

## 12. Maintaining Mystery

- Do not explain all triggers in the public UI.
- Keep most secrets optional and small.
- Never punish users for missing content.
- Use recurrence, not randomness alone: objects and characters should reappear with altered context.
- Make clues emotionally legible, not puzzle-hostile.
- Avoid completion language. The site is a place, not a checklist.

## 13. Implementation Notes

- Current state is client-side only through `localStorage` key `zxh_hidden_details_v1`.
- Secret routes are static Org pages.
- `#+HIDDEN_PAGE: t` excludes pages from sitemap/recently-updated via `lisp/sitemaps.el` and `lisp/recently-updated.el`.
- Add backend later only if real guestbook/comment persistence is desired.
- Keep hidden scripts dependency-free.

## 14. Canon Rule

The hidden soul should always imply: somebody lived here, somebody cared enough to label the drawer badly, and the visitor is welcome without needing to prove they found everything.

## 15. Second-Layer Text Registry

These are the newly added second-layer strings. The first-layer registry remains in `assets/scripts/hidden-details.js` as the original 102-detail foundation.

### Quotes

- The archive does not keep score. It keeps chairs.
- Some families pass down recipes. This one also passes down tabs left open for later.
- A page can be a room if enough people arrive softly.
- The oldest link on the site still expects a hand cursor.
- If a memory changes, it may be trying to fit through a smaller door.
- The guestbook is not empty. It is holding its breath between signatures.
- Every backup is a small superstition against forgetting.
- Somewhere in the CSS, a lamp is deciding whether to stay on.
- The radio under the stairs only plays songs it has already missed.
- A train can leave a station and still remain in the family story.
- Kindness is the only password the house accepts without checking case.
- The website learned your pace and stopped rushing the hallway.
- A draft is just a letter still gathering courage.
- The cursor is a visitor. The margin is a host.
- If you hover long enough, even a heading may remember being handwritten.
- The old forum banner says: welcome back, even if you are new.
- Not all broken pages need repair. Some need a name.
- The site keeps its mysteries low to the ground, where tired people can reach them.
- A year is a folder that keeps renaming itself.
- Some evenings are survived by the exact right mug.

### Poems

- A train in the rain / waits beside an empty platform / so memory can board.
- Grandma's radio / tuned between two stations / found us anyway.
- A flower pressed flat / still teaches the book / how spring once leaned.
- The lamp stayed awake / not because it was brave / but because someone might need it.
- Old usernames fade / but the welcome thread remains / warm at the top.
- I found a draft / with no ending / and felt less alone.
- The house at midnight / is mostly refrigerator hum / and unsent kindness.
- A calendar page / falls without bitterness / into tomorrow's hands.
- There is a road home / made entirely of small tabs / you meant to close.
- A cassette clicks / and the room becomes younger / for one more minute.

### Fake Conversations

- Nettle: The ticket drawer is humming again. Morrow: That is normal. It hums when someone is almost ready.
- Aunt Ma: Who put the screwdriver in the biscuit tin? Nadir: A person with vision and no labelling discipline.
- Morrow: The lamp keeps following the visitor. Etta: Good. Lamps should have hobbies.
- Old Guest 14: is this page still alive? Webmaster: yes, but quietly, please. the baby is asleep.
- Nettle: Filed under: feelings disguised as infrastructure. Morrow: Approved without changes.
- Luma: The radio said my name. Aunt Ma: Then say salaam back. Manners matter.
- Nadir: The server made soup noises. Etta: That means the deployment is nearly done.
- Morrow: I found a page that says do not open. Nettle: That usually means open gently.

### Journal Fragments

- Journal scrap, 2006: We changed the wallpaper and everyone pretended it was not emotional.
- Journal scrap, 2011: The old router blinked like it was trying to stay in the conversation.
- Journal scrap, 2018: I learned that homesickness can happen inside your own house.
- Journal scrap, 2024: Somebody laughed in the kitchen and the whole week became easier.
- Journal scrap, undated: The marigolds came back where nobody planted them.
- Journal scrap, undated: We kept the cracked mug because it knew too much.
- Journal scrap, winter: I saved a voicemail just to remember the background noise.
- Journal scrap, summer: The fan turned all afternoon and made the curtains look like boats.

### Comforting Warnings

- COMFORT WARNING: this page may contain traces of old carpet, warm rice, and unfinished errands.
- SOFT ERROR: the archive attempted to be impressive and became sincere instead.
- NOTICE: do not stack heavy feelings on the top shelf.
- LEGACY WARNING: this layout remembers 800x600 and asks you to be respectful.
- SYSTEM MESSAGE: no achievement unlocked. You were kind anyway.
- CACHE NOTE: the page kept a copy of the good part.
- RECOVERY MODE: make tea, rename file, try again.
- PERMISSION DENIED: the sadness may enter, but it must wipe its feet.

### Recurring Dreams

- Dream 01: a train full of empty mugs waited at a station called Later.
- Dream 02: the search box became a letterbox and returned every question with a family recipe.
- Dream 03: a radio under the stairs played tomorrow's weather in a grandparent's voice.
- Dream 04: the old homepage had a porch, and every link was a moth-wing-soft knock.
- Dream 05: someone had folded the sitemap into a paper flower and left it in a browser tab.

### Cassette Logs

- CASSETTE A / side 1: You can hear plates, rain, and someone saying, no, leave the light on.
- CASSETTE A / side 2: Three seconds of silence, then laughter too close to the microphone.
- CASSETTE B / side 1: Nadir explains backups to a child using rice grains and a spoon.
- CASSETTE C / side 2: A song with no words, hummed badly, loved completely.
- CASSETTE D / side ?: The tape label only says for when the house feels far away.

### Fake Users

- sunnydialup88: first!!!! but emotionally
- auntie-admin: please stop uploading files named newnewnewfinal
- railway_morrow: platform 3 smells like rain today
- nettle_mod: moved thread from Bugs to Feelings
- luma-lamp: does anyone else hear the margins singing
- guest_000: I signed this once and then grew up

### Rare Homepage Takeovers

- For one rare minute, the homepage believes it is an old family desktop.
- The dashboard has become a late-night noticeboard with one pin missing.
- The homepage found its old forum skin in a drawer and is trying it on.

### Seasonal Lines

- Winter: The archive put an extra blanket on the footer.
- Spring: A pressed flower appeared between two cached pages.
- Summer: The page opened a window and let the fan turn the silence.
- Autumn: The old links sound like leaves when the cursor passes.

### Secret Room Search Terms

- `radio under stairs` -> Radio Room.
- `guestbook 1999` -> Guestbook 1999.
- `do not open` -> Do Not Open.
- `cassette` -> Cassette Log.
- `return ticket` -> Train Platform.
- `unfinished letter` -> Forgotten Draft.
- `burnt sugar` -> Corrupted Recipe.
- `cupboard` -> Terminal Cupboard.
- `patience` -> Patience Game.

## 16. Maintenance Checklist

- When adding a new hidden page, include `#+HIDDEN_PAGE: t`.
- Add the route to the invisible link registry only if accidental discovery is acceptable.
- Add one lore connection, one emotional reason, and one non-obvious trigger.
- Keep text short in toasts; move longer writing into hidden rooms.
- Prefer local state and static pages. Add backend persistence only for explicitly public features.
- Rebuild with `emacs -Q --script build-site.el`.
- Verify secret pages build and do not appear in `sitemap.org` or `recently-updated.org`.