# Palace Examiner — Butler Guide

Palace Examiner is an investigative editorial app in the tradition of Hearst-era muckraking journalism. Content is curated editorial analysis based on documented public record.

## Structure

```
apps/palaceexaminer/
├── astro.config.mjs     (SSR node adapter, base: '/examiner')
├── package.json
├── run.sh               (builds + starts on port 4326)
├── com.manglasabang.palaceexaminer.plist
└── src/
    ├── layouts/Layout.astro
    └── pages/index.astro  ← all content + SPA logic embedded here
```

Data dir: `palaces/manglasabang/palaceappsdata/palaceexaminer/`

## Content Model

All subject dossiers are embedded in `src/pages/index.astro` as a `SUBJECTS` JavaScript array inside `<script is:inline>`. Each subject has:

- `id` — URL hash identifier
- `code` — Case file code (e.g. E-001)
- `initials` — Two-letter initial for portrait
- `name`, `title`, `born`, `status`
- `portraitColor` — CSS gradient for the portrait background
- `stampText` — Classification stamp overlay
- `lede` — Front page card teaser (3 sentences)
- `assessment` — Opening dossier paragraph
- `symptoms[]` — Array of `{label, body}` behavioral observations
- `origins[]` — Array of `{label, body}` documented biographical facts
- `verdict` — Closing editorial verdict

## Adding a New Subject

Add a new entry to the `SUBJECTS` array in `src/pages/index.astro`. The app auto-renders from the data — no UI changes needed. Rebuild and restart the daemon after changes.

## Deployment

Independent Astro SSR server. Managed by launchd daemon `com.manglasabang.palaceexaminer`.

- **Port:** 4326
- **Caddy route:** `/examiner/*` → `127.0.0.1:4326`
- **URL:** `https://palacering.com/examiner`
- **Daemon:** `launchctl kickstart -k gui/$(id -u)/com.manglasabang.palaceexaminer`
- **Logs:** `apps/palaceexaminer/logs/`

After editing content, restart the daemon — it rebuilds on start:
```bash
launchctl kickstart -k gui/$(id -u)/com.manglasabang.palaceexaminer
```