From 1baf3ba128f18986738c7072c4ce9742da08392e Mon Sep 17 00:00:00 2001 From: mdheller <21163552+mdheller@users.noreply.github.com> Date: Thu, 23 Apr 2026 09:58:01 -0400 Subject: [PATCH 1/5] runtime: switch staged sourceos-shell file provider to lampstand --- modules/nixos/sourceos-shell/default.nix | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/modules/nixos/sourceos-shell/default.nix b/modules/nixos/sourceos-shell/default.nix index e0e7cc4..a43f23b 100644 --- a/modules/nixos/sourceos-shell/default.nix +++ b/modules/nixos/sourceos-shell/default.nix @@ -44,8 +44,8 @@ in }; linuxFileProvider = lib.mkOption { - type = lib.types.enum [ "tracker3" "fd" "locate" ]; - default = "tracker3"; + type = lib.types.enum [ "lampstand" "fd" "locate" ]; + default = "lampstand"; description = "Linux-native file search provider used when scope=files."; }; }; @@ -72,6 +72,10 @@ in files = "linux-native-only"; web = "browser-agent"; }; + notes = [ + "Lampstand is the Linux-native file authority for scope=files." + "The launcher remains an action bus and must not perform a second file-search pass." + ]; }; systemd.services.sourceos-shell = { From be8b05d76b630ea96d72b48ea5ce1088f7cb0064 Mon Sep 17 00:00:00 2001 From: mdheller <21163552+mdheller@users.noreply.github.com> Date: Thu, 23 Apr 2026 09:59:33 -0400 Subject: [PATCH 2/5] runtime: align staged search-provider scaffold to lampstand --- linux/desktop/sourceos-search-provider.conf | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/linux/desktop/sourceos-search-provider.conf b/linux/desktop/sourceos-search-provider.conf index dc610ce..035d0b5 100644 --- a/linux/desktop/sourceos-search-provider.conf +++ b/linux/desktop/sourceos-search-provider.conf @@ -2,10 +2,14 @@ # This file records the intended launcher/search routing policy during early shell rollout. mode=launcher-bridge -linux-file-provider=tracker3 +linux-file-provider=lampstand invariant=no_redundant_file_search # scopes apps=launcher files=linux-native-only web=browser-agent + +# notes +# - Lampstand is the Linux-native file authority for scope=files. +# - The launcher remains an action bus and must not perform a second file-search pass. From 26deaad188ace1a8c5055fc733178d1ce70f5a5c Mon Sep 17 00:00:00 2001 From: mdheller <21163552+mdheller@users.noreply.github.com> Date: Thu, 23 Apr 2026 15:48:35 -0400 Subject: [PATCH 3/5] runtime: rename staged search mode from launcher-bridge to command-bus --- modules/nixos/sourceos-shell/default.nix | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/nixos/sourceos-shell/default.nix b/modules/nixos/sourceos-shell/default.nix index a43f23b..1be9482 100644 --- a/modules/nixos/sourceos-shell/default.nix +++ b/modules/nixos/sourceos-shell/default.nix @@ -38,8 +38,8 @@ in searchProvider = { mode = lib.mkOption { - type = lib.types.enum [ "linux-native" "launcher-bridge" "shell-native" ]; - default = "launcher-bridge"; + type = lib.types.enum [ "linux-native" "command-bus" "shell-native" ]; + default = "command-bus"; description = "Search routing mode during shell rollout."; }; @@ -74,7 +74,7 @@ in }; notes = [ "Lampstand is the Linux-native file authority for scope=files." - "The launcher remains an action bus and must not perform a second file-search pass." + "The command bus remains a frontend and must not perform a second file-search pass." ]; }; From 394b967aad1bda64c7cc5ccc860b17cfe5775739 Mon Sep 17 00:00:00 2001 From: mdheller <21163552+mdheller@users.noreply.github.com> Date: Thu, 23 Apr 2026 16:05:16 -0400 Subject: [PATCH 4/5] runtime: rename staged search-provider mode to command-bus --- linux/desktop/sourceos-search-provider.conf | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/linux/desktop/sourceos-search-provider.conf b/linux/desktop/sourceos-search-provider.conf index 035d0b5..b35fd7e 100644 --- a/linux/desktop/sourceos-search-provider.conf +++ b/linux/desktop/sourceos-search-provider.conf @@ -1,7 +1,7 @@ # SourceOS shell search-provider scaffold -# This file records the intended launcher/search routing policy during early shell rollout. +# This file records the intended command-bus/search routing policy during early shell rollout. -mode=launcher-bridge +mode=command-bus linux-file-provider=lampstand invariant=no_redundant_file_search @@ -12,4 +12,4 @@ web=browser-agent # notes # - Lampstand is the Linux-native file authority for scope=files. -# - The launcher remains an action bus and must not perform a second file-search pass. +# - The command bus remains a frontend and must not perform a second file-search pass. From a25ec7906b8a7e2345588a359cfe896b59f307a9 Mon Sep 17 00:00:00 2001 From: mdheller <21163552+mdheller@users.noreply.github.com> Date: Thu, 23 Apr 2026 16:05:52 -0400 Subject: [PATCH 5/5] docs(shell): rewrite launcher-bridge note as command-bus/search routing note --- docs/sourceos-shell-launcher-bridge.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/sourceos-shell-launcher-bridge.md b/docs/sourceos-shell-launcher-bridge.md index 87287df..2bfd034 100644 --- a/docs/sourceos-shell-launcher-bridge.md +++ b/docs/sourceos-shell-launcher-bridge.md @@ -1,6 +1,6 @@ -# sourceos-shell launcher bridge note +# sourceos-shell command bus note -During the early shell rollout, launcher integration is tracked as temporary bridge work. +During the early shell rollout, launcher/search integration is tracked as temporary command-bus work. ## Routing rule @@ -12,7 +12,9 @@ Queries are routed by scope: ## Required invariant -For `files` queries, Albert must not perform a second file-search pass in parallel with the Linux-native provider. +For `files` queries, the command bus must not perform a second file-search pass in parallel with the Linux-native provider. + +Lampstand is the intended Linux-native file authority for this lane. ## Realization scaffolds @@ -21,8 +23,8 @@ The Linux realization currently carries placeholder search-provider material at: - `linux/desktop/sourceos-search-provider.conf` - `/etc/sourceos-shell/search-provider.json` (realized by the shell Nix module scaffold) -These capture the intended rollout mode and the provider choice for the Linux-native file search lane. +These capture the intended rollout mode, routing invariant, and the provider choice for the Linux-native file search lane. ## Lifecycle -This bridge exists only until the shell's own command/search surface fully absorbs the routing behavior. +This command-bus/search-provider surface exists only until the shell's own command/search runtime fully absorbs the routing behavior.