Repository navigation
feat(luban, xlings): Luban OS ecosystem usability -- machine xlings, situation/broker, creation flow, xdesk, CI - #693
Merged
Merged
Conversation
… 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
force-pushed
the
luban-ecosystem-usability
branch
from
October 21, 2026 20:05
3f20c67 to
c075c2c
Compare
…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>
…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>
…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
marked this pull request as ready for review
October 22, 2026 04:51
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
XDG_DATA_DIRSkeeps its default.xlings.subos.situation); a machine's broker carriessudo xlings install/remove/updateand a user's store addition to the host; a user's own versions need no sudo,xlings updatesayssudo xlings update./etcfile deleted under its mount is left out of a sandbox instead of failing it.Machines
xim:virtiofsdinstalled the first time,--sandbox namespacethennone), 9p where it cannot be (no KVM, no daemon);luban config --files, said inluban status. Measured:find /usr3955 → 359 ms, reading libraries 1041 → 130 ms.--userwith a name the system lacks is refused, never root.{active, installed}entries as versions and skipped all; the export now names each program's package); a sudo install survivesluban upgrade./dev/dxgprobed and said.The bus, observability, desktop
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).test_xdesk_interaction).CI and checks
run,launcher,gui,sound.LUBAN_OS_CI_TOKENis there; luban-os-ci's first local runs found the bugs above.--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