Shared primitives for apps::metadata and shells::metadata’s
shine.toml/category loaders: embedded-category-name discovery,
filesystem-category-name discovery, platform filtering, and the
filesystem tree walk + base/overlay merge used to auto-collect files for
categories without an explicit [[files]] list.
Shared sentinel-block primitives used by shells::profile and
sys::profile to find, extract, remove, and insert the
# >>> ... >>> / # <<< ... <<< blocks shine writes into user-owned
shell profile files.
Shared POSIX shell-quoting helpers for rendering commands back into copy-paste-safe or
sourceable shell syntax. Display-only: task::mod and apps::upgrade never execute the
quoted string itself, they always run the underlying argv directly via
std::process::Command/tokio::process::Command, so this module has no injection surface
of its own.
shine ssh: wraps the system ssh binary to establish an interactive
session that also carries a session-scoped file-transfer channel back to
the local machine (see docs/ssh-local-transfer-prd.md).
shine theme sync: resolves the terminal’s light/dark theme and prints
shell-safe export statements for SHINE_TERMINAL_THEME and BAT_THEME.
See docs/terminal-theme-sync-prd.md for the full design and
docs/kb/lessons.md (2026-07-14) for why the old shell-only OSC read loop
was replaced.