AGENTS.md@packages/electron/resources git:20260712.8bdcf28A

Immutable. This exact content is served forever at /api/v1/blob/938bc94b9cdd398b.

# DOX — packages/electron/resources

Files in this directory. One row per source file.

| File | Purpose |
|------|---------|
| `dirname-shim.js` | ESM global shim loaded via `node --import`. Defines `globalThis.__dirname` (returns `process.cwd()`) + `globalThis.__filename` fallback for CJS deps (node-pty) loaded as ESM. |
| `loading.html` | Electron loading page (`loadFile` after `createMainWindow`). Polls `serverUrl`+`/api/health`, navigates `location.href=serverUrl` on ok, else retries → `showError()` after ~10 attempts (~15s) with Start-server / Open-Doctor / server-log + known-servers buttons. Remote attach (change: fix-remote-connect-cors-gates): for a **non-loopback** `serverUrl` with `piDashboard.probeServer`, reachability comes from the MAIN-process probe (Node fetch, no Origin, not CORS-bound) instead of a renderer `fetch` — a remote deliberately refuses this `file://` page's `Origin: null`, so a renderer fetch would hang. Loopback / older-preload fallback keeps the renderer fetch path. Known-servers buttons unchanged (raw `location.href`). |