Skip to content

Splinterm 0.1.0-rc.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@OldJobobo OldJobobo released this 03 Sep 23:12
v0.1.0-rc.1
5fe4879
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Splinterm 0.1.0 RC1 — Stable Ground

This is the first release candidate for Splinterm 0.1.0. It freezes the 0.1
feature line for stabilization and carries the complete public Beta 3 baseline
plus bounded fixes for Omarchy environment refresh, live font following, Yazi
image previews, and legacy Dojo restore names.

RC1 is intended for normal daily use and soak testing on the documented target:
x86_64 Omarchy/Arch Linux with native Wayland under Hyprland. A code change after
RC1 requires another release candidate before the final v0.1.0 release.

Live Omarchy font following

When main.font is unset, a valid change to Fontconfig's effective monospace
family now replaces one complete immutable renderer generation without
restarting the Window, daemon, shell, or applications. Explicit font patterns
remain authoritative, and an invalid live generation retains the last valid
family.

Font changes preserve configured size and sizing policy, padding, DPI, runtime
zoom, topology, focus, history, modal and IME state, and controller authority.
Observer panes never acquire control solely to resize after a font change, and
deferred font-driven resizes retry after transient command-queue backpressure.
Fontconfig named instances in variable fonts are preserved through shaping,
metrics, and rasterization. Ambient Fontconfig checks run at a bounded ten-second
cadence.

Yazi uses bounded Sixel previews

When Sixel is enabled, Splinterm now advertises primary device attribute 4.
Yazi therefore selects its Sixel image path instead of the incompatible legacy
per-cell Kitty placement path. The capability remains conditional, and the
existing image-content and 256-placement bounds are unchanged.

Legacy Dojo names normalize on restore

Loading schema-v2, schema-v3, or schema-v4 metadata now replaces only the exact
historical generated forms terminal, terminal-<timestamp>, and
terminal-<timestamp>-<pid> with collision-free Dojo N names. Numeric fields
may be zero-padded, matching names emitted by older builds. Explicit names in
current schema metadata are preserved.

New Splints follow the current Gum palette

splinterd is persistent, so environment variables inherited when the daemon
started can outlive an Omarchy theme change. Before RC1, a newly created shell
could therefore receive stale Gum colors even though Splinterm's graphical
palette already reflected the active theme.

For every new Splint, the daemon now reads the active rendered palette from:

${XDG_STATE_HOME:-$HOME/.local/state}/omarchy/current/theme/gum_env.lua

It refreshes only Omarchy's bounded Gum environment namespace:

  • GUM_*;
  • FOREGROUND and BACKGROUND; and
  • BORDER_FOREGROUND and BORDER_BACKGROUND.

A complete valid palette replaces current managed values and removes obsolete
managed GUM_* entries. Unrelated environment variables remain untouched.
Existing PTYs keep the environment with which they were created; only later
Splints see a later valid theme.

Missing, malformed, oversized, symlinked, or non-regular palette state fails
closed. In those cases the new PTY preserves the daemon's inherited environment
rather than receiving a partial palette.

Stabilized Beta 3 baseline

RC1 retains the Beta 3 workload and interface corrections:

  • terminal workloads inherit the systemd user manager's task policy while
    splinterd.service keeps its independent TasksMax=2048 guard;
  • the New Dojo control sits after the final visible tab;
  • inactive tabs use semantic dividers; and
  • the strict historical unnamed initial Dojo form is presented as Dojo 1
    without mutating daemon-owned topology.

Persistent topology, explicit restore, scrollback and search, terminal images,
remote graphical access, JSON/NDJSON automation, MCP, configurable terminal
lifetime, presets, and the documented native Wayland path remain part of the
0.1 baseline.

Upgrade boundary

Splinterm 0.1 does not support live daemon upgrade handoff. Upgrading Beta 3 to
RC1 therefore ends active Dojos. Run the upgrade from Foot or another terminal
that is not owned by splinterd:

systemctl --user stop splinterd.service
# upgrade the splinterm package here
systemctl --user daemon-reload
systemctl --user start splinterd.service

Then reopen Splinterm Windows. Package installation does not silently reload or
restart the user service.

RC1 soak focus

During the release-candidate soak, please pay particular attention to:

  • repeated Omarchy theme changes followed by newly created Splints;
  • existing PTYs retaining their original environment;
  • clean installation and Beta 3 upgrade/rollback;
  • saved-Lair restore and ordinary long-running terminal workloads;
  • trusted graphical-client identity and desktop launching; and
  • optional MCP package behavior when installed.

RC1 remains a prerelease. If stabilization requires any code change, the next
public build will be RC2 rather than the final v0.1.0 release.

Assets 7
Loading