Kingdom.md — current plan (orientation pin)

The session "you are here" for the kingdom-md project. The real plans live in their own docs (linked under Threads); this file is the lightweight pointer the next /good-morning reads first.

Current Checkpoint — 2026-06-22 (hovercard header redesign + ai-agents kingdom)

Just finished: Reworked the sidebar file hovercard — added a soft-accent header band (shows the frontmatter title, or the filename when there's none) with the filename demoted to the first body row; widened the card ~20% (270→324px), tuck-compensated the left padding so the visible left gap matches the card's bottom, added ellipsis truncation, and removed the native title= tooltips from the nav (they obscured the flyout; visible label text stays as the accessible name). Also registered the ai-agents kingdom → /var/projects/LandSandBoat/documentation/ai_agents (LandSandBoat FFXI-server repo cloned to /var/projects/LandSandBoat, no submodules). Landed on main as two feature commits + this pin.

In progress: Nothing half-built. main is the single checkout (no session worktree); the native stack serves directly from it (CSS is a Vite build — npm run build after editing).

Next step: Either build Mercury (/planning → mercury-plan.md: read canonical Hermes source, add SOUL.md to findLanding, author an exemplar slice, register mercury in config/kingdom.php) or chase viewer follow-ups: /yggdrasil tree loads in ~11s (no tree caching; large repo), non-.md files stay hidden by the .md-only gate, and the de-Docker doc pass over this repo's own docs (CLAUDE.md + working/, bookmarked).

References: working/mercury-design.md (next build); bookmarks.md (de-Docker pass + blockquote-margin experiment); hovercard code → resources/js/app.js (kmHovercard), resources/views/partials/tree.blade.php, resources/css/app.css (.hc-title).

Threads

  • Viewer UI polish — ✅ 2026-06-22: sidebar file hovercard gained a soft-accent filename/ title header band (frontmatter title → header, filename demoted to the first body row), card widened to 324px, left padding tuck-compensated, native nav title= tooltips removed. Code: resources/css/app.css (.hc-title), resources/js/app.js, partials/tree.blade.php. Also added the ai-agents kingdom (LandSandBoat AI-agent docs) in config/kingdom.php.
  • Native serving / deployment — ✅ live (2026-06-20): migrated off Docker/Sail to a native nginx → php-fpm → SQLite → Vite stack on the DO droplet; HTTPS at https://claude.hugin.gg, cert auto-renews, services autostart on reboot. Full standup recipe in yggdrasil/working/laravel.md. Follow-up: de-Docker this repo's own docs (CLAUDE.md + working/), bookmarked.
  • MVP build → working/mvp-plan.md — ✅ all 7 tasks done, Pest suite green, merged to main (9c0c64a).
  • Demo kingdoms → working/demo-kingdoms-design.md — the portfolio design.