Skip to content

feat(luban, xlings): Luban OS ecosystem usability -- machine xlings, situation/broker, creation flow, xdesk, CI - #693

Merged
Sunrisepeak merged 45 commits into
mainfrom
luban-ecosystem-usability
Oct 22, 2026
Merged

Sunrisepeak merged 45 commits into
mainfrom
luban-ecosystem-usability

Conversation

@speak-agent

@speak-agent speak-agent commented Oct 21, 2026 •

Copy link
Copy Markdown
Collaborator

Luban OS ecosystem usability (design .agents/docs/2026-10-21-luban-os-ecosystem-usability-design.md), xlings 2026.10.22.1. One commit per checkpoint; with xim-pkgindex#1022, mcpp-community/mcpp#831 and luban-os/luban-os-ci#1.

xlings in a system

  • K1: recipes are read in a Luban machine (the mount table names the filesystem; Landlock on uncached 9p; worker scratch local); an unset XDG_DATA_DIRS keeps its default.
  • K2/K4: one place decides where a change goes (xlings.subos.situation); a machine's broker carries sudo xlings install/remove/update and a user's store addition to the host; a user's own versions need no sudo, xlings update says sudo xlings update.
  • A user's view starts with the system's subos description (its doctor is clean); what xlings sets for a session (prompt facts) passes whatever the policy; an /etc file deleted under its mount is left out of a sandbox instead of failing it.

Machines

  • K6: files over virtio-fs (a virtiofsd a share, xim:virtiofsd installed the first time, --sandbox namespace then none), 9p where it cannot be (no KVM, no daemon); luban config --files, said in luban status. Measured: find /usr 3955 → 359 ms, reading libraries 1041 → 130 ms.
  • Commands at once each run to their end; a machine started for commands powers off when the last ends (leases, under one lock); a command whose machine goes away says so; --user with a name the system lacks is refused, never root.
  • An archive's packages come along again (import read {active, installed} entries as versions and skipped all; the export now names each program's package); a sudo install survives luban upgrade.
  • K14: WSL's /dev/dxg probed and said.

The bus, observability, desktop

  • openbus/XBus: routers, nodes, links across machines (luban status --bus), streams and regions, telemetry on every node (§8.3); a frame begun is finished before any other (macOS's small socket buffers).
  • The telemetry kit (metrics, flight recorder, logs, spans, Chrome traces); the i18n kit shared by xlings and xdesk.
  • K7: frames compressed across a narrow channel (opensal 0.6), damage merged.
  • K11/K13: xdesk bookmarks, collapse, minimap, title bars, free-window resize; the tour; every layout, window and interaction drivable headless and covered (test_xdesk_interaction).

CI and checks

  • P2's xlings side: package checks run, launcher, gui, sound.
  • K15: the release candidate is dispatched to luban-os-ci's L2 when LUBAN_OS_CI_TOKEN is there; luban-os-ci's first local runs found the bugs above.
  • Recorded for later (design §15): K5 (--store own), J32 (a machine's new users cannot own their homes), J33 (a user view's install is active for everyone).

Co-authored-by: speak-agent 248744407+speak-agent@users.noreply.github.com

Sunrisepeak and others added 9 commits October 22, 2026 00:51
… its default (K1)

A Landlock rule on 9p without an inode cache stopped matching once its directory left the dentry cache (J1): the fence holds its directories open across exec, the filesystem type comes from the mount table (9p answers statfs with the host's), and a worker on a remote home keeps its scratch in the user's local runtime directory. An unset XDG_DATA_DIRS/XDG_CONFIG_DIRS keeps /usr/share and /etc/xdg behind what a shim, a session, subos use and a machine's qemu put in front (J28). Design 2026-10-21 (ecosystem usability).

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…hine's broker (K2, K4)

xlings.subos.situation measures where xlings runs (host, sandbox, machine, a system booted as itself), who runs it (owner, the system's administrator, a user's view) and which store it reads (personal, shared, own), from the system's root record; one route table says here, the host's broker, sudo, the owner on the host, or one line when the host has no broker. The command line, the home's user view, the installer's borrowing (the store and the scope the root names) and the lock's message read it. broker::classify says what a command touches; broker::judge is the verdict every supervisor gives. A Luban machine's agent offers /run/xlings/broker.sock to root once the host says it has a broker (A frame); each request is a channel of the guest's (B), the host's bridge runs xlings subos __broker-serve on a terminal or pipes, the audit names who asked, and /usr follows the new generation. A user in a system installs for themselves; updating the index says sudo xlings update. Flags after -- are another command's (subos exec, a broker request). Design 2026-10-21 §3.0, §3.2, §3.3.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…events and stops when cancelled (K8)

A stage is full when the next begins or the operation ends, never because one step in it ended (J6). install_packages takes subos (protocol 1.17): a Luban system's packages are installed where it lives, events relayed through the one path out of a domain (relay_capability_), so luban's extra packages and desktop have events and can be cancelled. A cancel is SIGTERM first and SIGKILL after 10 seconds; xlings's interface turns it into the call's cancel and stop_requested -- nothing more started, nothing made another way, the half set aside as .unfinished-<name>-<pid>, E_CANCELLED, 130 (J7). A name held by one of the window's tasks is not taken over by another. The operation that made a system links to the system's own record; xlings self log follows it and --subos names the latest operation on a system (luban status <name> --log); luban ls --all and luban rm --unfinished. Output: the mirror and the retained-for-rollback lines in -v; the privileged-variable notice once per package. Design 2026-10-21 §7, §3.5.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…t record read on every host

SUBOS-MACHINE-BROKER gains an e2e of subos __broker-serve; the Landlock test's held-directory loop no longer ends the shell with its last comparison; parse_root_record reads a POSIX path on Windows too.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…or Super, a console paced, the hint and the badge in place (K9)

The window tells the system a key is up when the focus goes, and on X11 reconciles held keys with XQueryKeymap (a window manager's grab took the release: the space repeated); with the keyboard held, Super down and the pointer inside, the pointer is held so GNOME's Super+drag does not move the window; a Super key the host kept says Ctrl+Alt+K once (J16). A console's writes wake the window at most once a frame (J23). xdesk draws its hint again at a new size or density (J10). The new-system card's tier marks sit in its top right corner (J29). Design 2026-10-21 §8.10, §8.12, §8.13, §6.2.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…er a dimmed layer of their own (K10)

No ring drawn around the chosen window: its own outline, in the accent, the one under the pointer's faint. After a choice the chosen outline is held while the windows settle, then fades in half a second where it is -- the others are no longer dimmed and lit again; with less motion nothing is lit (J15). The switchers gather windows on a layer of their own over a dimmed output, above the workspaces' plates and labels in the WuXian view (J14). Design 2026-10-21 §8.2, §8.3.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
… by its parts (K12)

state answers the output and renderer, view and camera, workspaces, windows, the overlays (the hint's place: inside the output after a resize, J10), the launcher's applications, the channels, and the frames' parts over ten seconds -- composing, reading back, sending, bytes, whole frames -- measured in render() (design §5.6a's first step). debug hud draws them on the output; subscribe writes focus, open, close, actions, overlays and view changes a line each. Part 2 (openbus and XBus) is written beside part 1.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…outer and nodes (part 2, B1-B3)

luban/specs/openbus: the model -- nodes expose and use objects (paths, interfaces, properties, composites) the same way, call, publish/subscribe, broadcast, stream, event and region as one 24-byte-header frame with envelopes, links between routers, quality of service, regions with placement, coherence and tier, verbs, tasks and actors, what every router tells (bus/stats, bus/topology, bus/verbs, bus/trace) -- with a conformance check any router can be run against. luban/services/xbus (a new kind of package: base services, apart from kits, which are libraries): a single-threaded router, a node library that reconnects and says everything again, links over any pipe a program moves; nothing above it is a platform's -- addresses (local:, unix:), pipes, opaque handles in a backend (POSIX, Windows; openkal's later). Design 2026-10-22 (part 2).

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
@speak-agent
speak-agent force-pushed the luban-ecosystem-usability branch from 3f20c67 to c075c2c Compare October 21, 2026 20:05
Sunrisepeak and others added 20 commits October 22, 2026 05:15
…nks; the xbus tool

A router answers bus/link with an address and joins that bus; a pattern
that begins with a wildcard asks everywhere the router knows of. The
xbus tool lists, calls, watches and benches a bus.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…tured log, profiling and dumps; every XBus node and router tells its own

luban/kits/telemetry: counters, gauges and 64-bucket histograms by name,
the last records kept whatever a log's level, one JSON object a log line
with rotation, spans that feed histograms and while profiling a Chrome
trace, dumps that name a failed provider; telemetry::control is the whole
interface. openbus SPEC 8.3, openbus.telemetry@0.1: the router answers at
bus/telemetry, each node at node/<id>/telemetry; an answer larger than a
frame comes in pieces. XBus logs, counts and profiles itself with it;
xbus dump and xbus profile read any process on the bus. A patient node
starts before its router and connects when one comes.

xlings.libs.json re-exports mcpp-index's nlohmann.json: one copy of the
library in every program (two copies conflict in a unit that sees both).

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…s, and its frames as telemetry (part 2, B6)

A patient XBus node: service/xdesk/state, service/xdesk/control (the
control socket's requests and answers) and topic/xdesk/events; the bus's
thread posts to the Wayland loop and is answered from there. A frame's
parts are telemetry metrics and, while profiling, spans; a dump carries
the desktop's state. xdesk msg telemetry asks the same over the socket.
A kit never imports a service (lint); xdesk may, as a program.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…inked through L frames, the host's router one per home (part 2, B5)

The guest agent runs the system's openbus router (/run/openbus/router.sock,
OPENBUS_ROUTER in its sessions; joining it to another is root's) and, once
the supervisor's A provides openbus with the system's root, links it under
the host's: the supervisor moves the link's bytes as L frames to this
home's router, started by the first that needs it (luban __bus-router
<home>); an ended link is made again by the guest. XBus: listening refuses
a place a live router answers at; shared sockets for a system's router;
adopt and link from any thread; a router with links is not idle.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…s no other way to it); the bench removes its directory

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…nline where the way carries no memory; xbus bench stream and region, reported in CI (part 2, B4)

Node::open and offer_stream: ordered bytes both ways, a write waits for
credit, what is read is granted again. Stream::create_region announces a
memfd the other side maps (a reference is 24 bytes, read in place); a
side that cannot map it answers region-release with region-kind and the
region goes inline, each reference carrying its bytes in pieces -- across
a link over a pipe, by itself, counted. openbus SPEC 3 and 6.2 say how.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…cts seen through its link; xbus released beside luban; docs: the bus (part 2, B6-B7)

An offer over a link carries the node and name that offer it, so a resolve
on the far side names the program, not the link. xbus is in the xlings
archive on every platform and travels with the entry as luban does.
docs/luban/09-bus.md (en, zh); the architecture's packages.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
… windows collapse, free windows resize in the WuXian view, the minimap moves things, windows keep their title bars on the screen (K11)

openwx 0.1: a workspace's collapsed and a free window's collapsed flag
(no new version), and advisory interaction 5.1-5.5. xdesk.layout: covered()
-- what shows nothing on the screen, and the top-most over its centre --
and collapsed workspaces (a label strip, their windows not placed) and
free windows (a title bar). xdesk: bookmarks on the item over a covered
one (five, then +N), hover outlines, a click raises and focuses, hidden
while the view moves; Super+S and double-clicks collapse; a free window's
borders resize it in the WuXian view, title bars are hit within 24 px,
pictures move whole; the minimap pans, focuses and moves; stacked and
floating windows keep 64 px of their title bars on the output. xdesk msg
bookmark N; the state says bookmarks and collapsed items.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…ontrol, what happened read from the state

xdesk's control takes {"input": [...]} (move, click with a count,
button, wheel, key, keydown, keyup) through the window's own path, and
the state says what tests point at: whether windows glide, workspaces'
frames, bookmarks (lit), the minimap, the drag, maximized, full screen,
pinned, sticky. Each press is in the flight recorder. The Luban OS
script waits for a file (untilfile) so a test holds a session as long as
it needs. XdeskSession drives one; test_xdesk_interaction covers the
keys, stacked bounds and bookmarks, free windows' borders, collapse and
pictures, workspaces' labels and corners, panning and zooming, and the
minimap (whose view box is taken by its edge). README: what is tested where.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…lt on and xdesk's words use

luban/kits/i18n (module i18n): catalogues by domain and language, the
fallback chain to English, the check, pick, the glossary -- the mechanism
moved out of modules/i18n, the standard library only (the system's
language is the environment's unless a program gives its own source).
xlings.i18n is it under xlings::i18n with xlings' default domain and the
platform's language (Windows' user locale). xdesk's 227 words leave its
five copies of tr_(zh, en, cn): its text is English where it is used and
its Chinese is xdesk.words' catalogue; a test scans its sources for a word
without Chinese, and the catalogues check clean. The new-workspace action
reads New workspace (one English, one Chinese).

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…n once, again from the launcher (K13)

The first session gives it at the bottom right: the applications, a
terminal, switching, workspaces, WuXian, moving between them, bookmarks,
collapsing, every key, the settings -- each finished by the event the
desktop tells when it is done (launcher, action, view, drop, bookmark,
collapse), skippable, endable; ended early, the keys' line as before.
state.json keeps toured; Tour of the desktop in the applications and
xdesk msg tour start|skip|end; the state says where it is. Its words are
xdesk.words'. The hint's place (J10) is the tour's too, after a resize.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…nnel, damage merged rather than sent whole (opensal 0.6, K7)

opensal 0.6 Compressed: a provider across a machine's serial port or a
relay says it, and 'z' frames carry the rows as one LZ4 block -- the block
format implemented in the specification's own module (the standard library
only), sent only where shorter; a desktop's frame is under a tenth. The
Luban OS window provides it on a machine's or relay's channel; xdesk and the
opensal-wlr bridge send it. xdesk merges the nearest damaged rectangles
down to eight instead of sending the whole frame past eight; the frame's
compression time and the bytes saved are telemetry.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
… once and for good -- the other side goes inline

Windows' sockets pass no handles (not tried); a POSIX one that refuses one
(macOS CI's region announce ended its stream) falls back the same way.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…er node, so a machine's virgl and the desktop's GLES fall back to software and say why (K14)

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…d -- the launcher's entry checked from anywhere, a window and a sound in a desktop session (P2's xlings side, design 2026-10-21 §6.1)

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…tside

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
… installed the first time, 9p where it cannot be; luban config --files, said in status (design 2026-10-21 §4, K6)

Measured on a KVM machine: find over /usr 3955 ms on 9p, 359 ms on virtio-fs;
reading 27 MB of libraries 1041 ms against 130 ms. Ownership behaves the same
(chown EINVAL, chmod works). A daemon refused its namespaces runs without its
sandbox; one that does not start leaves the machine on 9p; a package that
cannot be installed is tried again a day later.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…r's; a flooding console waits for its writer; titles compared as strings (MSVC's string_view is ambiguous against json)

The tour's card covers the output's corner where the minimap and the tiled
blue window are sampled; the flood's writer is slower than 2.5 s on a busy
runner, so the test waits for it and bounds the wakes by the time it took.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…ot be announced says which way -- the stream test prints the flight recorder when it fails

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
Sunrisepeak and others added 13 commits October 22, 2026 09:52
…ame no longer lands between a bulk frame's pieces ("bad magic" on macOS, whose 8 KiB socket buffer writes in pieces)

Found by the node's new xbus-lost line on macOS CI; reproduced on Linux by
a channel that takes 3000 bytes a write.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…der TCG crashed an aarch64 guest's init; the speed is KVM's

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…; the design records P4 (Mesa's d3d12 is there) and M1 (mcpp#831)

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…machine started for commands powers off when the last of them ends; a command whose machine goes away says so

Two luban run in one machine: the one that started it powered it off at its
end, and the other ended with no output and no word (exit 125). Each command
now holds a lease (<run>/commands/<pid>); a machine started for commands
(<run>/for-commands) powers off when the last lease is given back; luban
enter makes it a machine someone keeps. Found by luban-os-ci's L2 run.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…own is EINVAL on 9p and virtio-fs), with the options; K5 deferred with its reasons

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…maintainer's token is there; said and passed when not (design 2026-10-21 §9.6, K15)

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…sed -- a name its system does not have ran the command as root

Found by luban-os-ci: a fixture's user that the edition never made ran
every scenario as root, exit 0. The agent now answers 126 and says there is
no such user.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…d asks for a user it does not have; docs say both

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…- the same on every host its tests run

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…N_PERSIST, PS1) passes whatever the policy, no warning; an /etc file deleted under its mount is left out of a sandbox rather than failing it

An agent workspace said '! env not in effect: --env LUBAN_KIND ...' on every
command: xlings' own facts for the prompt went through the caller's --env
check. They are now the request's system_env. A host whose /etc/ld.so.cache
has no name left (a container's file replaced under its bind) failed every
Lua worker's bwrap, and with it the catalog (luban-os-ci L2-12, L2-14).

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…'s subos description -- its doctor no longer finds its subos broken (luban-os-ci L2-07)

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…the prompt was lost on every backend; a test holds them to it

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
…kspace entries as versions, and since they became {active, installed} it skipped every one: luban import, a move into its own userland and its rollback dropped what was installed beyond the edition

The export now also says which package provides each program's version
(the home's version database), so a program bound to another's package
(bash to fish) installs that package once; an archive from before reads the
namespace off the version's key. Found by luban-os-ci's L2-12 (a sudo
install gone after luban upgrade).

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
Sunrisepeak and others added 2 commits October 22, 2026 12:18
…ost to that one's power-off -- whether it runs and the lease, the lease back and the power-off, each under one lock

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
@speak-agent
speak-agent marked this pull request as ready for review October 22, 2026 04:51
@Sunrisepeak
Sunrisepeak merged commit d1f80a7 into main Oct 22, 2026
34 checks passed
Sunrisepeak added a commit to openxlings/xim-pkgindex that referenced this pull request Oct 22, 2026
… to play; xlings 2026.10.22.1 (#1022)

The index side of xlings 2026.10.22.1's Luban OS ecosystem usability (xlings design .agents/docs/2026-10-21-luban-os-ecosystem-usability-design.md; openxlings/xlings#693).

- xim:xdesk links its share/applications (J9); every Luban program declares its checks (extensions.luban.checks: run, launcher, gui, sound; P2), with a lint.
- xim:virtiofsd 1.14.0, static, built here from upstream's tag (P3): a Luban machine's files over virtio-fs.
- A component's own musl loader searches only its tree (an empty ld-musl-<arch>.path): Falkon no longer crashes in a machine on a glibc libvulkan (J12, P5); every component with a loader bumped.
- luban:audacious 4.5.1-r1 and luban:sample-music 2026.10.22 (the Open Goldberg Variations' Aria, CC0): the desktops' player and a piece to play (P5a).
- P7: xlings, luban, luban-os, xdesk 2026.10.22.1; luban:xdesk 2026.10.22.1 with luban:audacious (older versions' revisions bumped); luban:desktop 2026.10.22.1.

Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants