skyllc-ai
diff --git a/‎Cargo.lock‎
Lines changed: 10 additions & 0 deletions b/‎Cargo.lock‎
Lines changed: 10 additions & 0 deletions
diff --git a/‎assets/brand/app.manifest‎
Lines changed: 41 additions & 0 deletions b/‎assets/brand/app.manifest‎
Lines changed: 41 additions & 0 deletions
diff --git a/‎crates/uffs-bench/Cargo.toml‎
Lines changed: 5 additions & 0 deletions b/‎crates/uffs-bench/Cargo.toml‎
Lines changed: 5 additions & 0 deletions
diff --git a/‎crates/uffs-bench/build.rs‎
Lines changed: 40 additions & 0 deletions b/‎crates/uffs-bench/build.rs‎
Lines changed: 40 additions & 0 deletions
diff --git a/‎crates/uffs-broker/Cargo.toml‎
Lines changed: 6 additions & 0 deletions b/‎crates/uffs-broker/Cargo.toml‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎crates/uffs-broker/build.rs‎
Lines changed: 46 additions & 0 deletions b/‎crates/uffs-broker/build.rs‎
Lines changed: 46 additions & 0 deletions
diff --git a/‎crates/uffs-broker/src/broker/service.rs‎
Lines changed: 27 additions & 0 deletions b/‎crates/uffs-broker/src/broker/service.rs‎
Lines changed: 27 additions & 0 deletions
diff --git a/‎crates/uffs-cli/build.rs‎
Lines changed: 37 additions & 0 deletions b/‎crates/uffs-cli/build.rs‎
Lines changed: 37 additions & 0 deletions
diff --git a/‎crates/uffs-cli/src/args.rs‎
Lines changed: 10 additions & 2 deletions b/‎crates/uffs-cli/src/args.rs‎
Lines changed: 10 additions & 2 deletions
diff --git a/‎crates/uffs-cli/src/commands.rs‎
Lines changed: 1 addition & 0 deletions b/‎crates/uffs-cli/src/commands.rs‎
Lines changed: 1 addition & 0 deletions
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<!--
+  SPDX-FileCopyrightText: 2025-2026 SKY, LLC.
+  SPDX-License-Identifier: MPL-2.0
+
+  Shared UFFS application manifest, embedded into the Windows binaries
+  (uffsd, uffs-broker, uffsmcp, uffs-mft) via winresource in each crate's
+  build.rs. The interactive CLI (uffs.exe) keeps its own crate-local manifest.
+
+  Declares:
+    - asInvoker: elevation is handled at runtime (the Access Broker service /
+      the daemon elevation policy), never at the manifest level.
+    - PerMonitorV2 DPI awareness.
+    - Long-path support (paths > 260 chars, which UFFS routinely handles).
+    - Windows 10 / 11 supported-OS id.
+-->
+<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
+  <assemblyIdentity type="win32" name="UltraFastFileSearch" version="0.0.0.0"/>
+
+  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
+    <security>
+      <requestedPrivileges>
+        <requestedExecutionLevel level="asInvoker" uiAccess="false"/>
+      </requestedPrivileges>
+    </security>
+  </trustInfo>
+
+  <application xmlns="urn:schemas-microsoft-com:asm.v3">
+    <windowsSettings>
+      <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2</dpiAwareness>
+      <longPathAware xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">true</longPathAware>
+    </windowsSettings>
+  </application>
+
+  <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
+    <application>
+      <!-- Windows 10 (Windows 11 shares the same supportedOS GUID per MS docs). -->
+      <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}"/>
+    </application>
+  </compatibility>
+</assembly>
@@ -74,5 +74,10 @@ tempfile.workspace = true
 # ─────────────────────────────────────────────────────────────────────────────
 # Lints (inherit from workspace)
 # ─────────────────────────────────────────────────────────────────────────────
+# Embeds the UFFS icon + version info + shared app.manifest into `uffs-bench.exe`
+# (see build.rs) for branding consistency.
+[build-dependencies]
+winresource.workspace = true
+
 [lints]
 workspace = true
@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: MPL-2.0
+// Copyright (c) 2025-2026 SKY, LLC.
+
+// Build scripts run on the build host, not the shipping binary's target, so the
+// workspace `deny(expect_used)` / `deny(unwrap_used)` runtime lints do not
+// apply here; panicking on a build-host failure (missing icon / no resource
+// compiler) is the idiomatic shape for a build script.
+#![allow(
+    clippy::expect_used,
+    reason = "build scripts may panic on build-host failure; workspace deny-expect targets runtime code"
+)]
+
+//! Build script for `uffs-bench`.
+//!
+//! Embeds the UFFS icon + version info + shared `app.manifest` into
+//! `uffs-bench.exe` via [`winresource`](https://crates.io/crates/winresource),
+//! for branding consistency with the rest of the UFFS binary family.
+//! MSVC-Windows only; a no-op on every other build target.
+
+fn main() {
+    println!("cargo:rerun-if-changed=build.rs");
+    println!("cargo:rerun-if-changed=../../assets/brand/icons/uffs.ico");
+    println!("cargo:rerun-if-changed=../../assets/brand/app.manifest");
+
+    let target_os = std::env::var("CARGO_CFG_TARGET_OS").unwrap_or_default();
+    let target_env = std::env::var("CARGO_CFG_TARGET_ENV").unwrap_or_default();
+    if target_os != "windows" || target_env != "msvc" {
+        return;
+    }
+
+    let mut res = winresource::WindowsResource::new();
+    res.set_icon("../../assets/brand/icons/uffs.ico")
+        .set("ProductName", "UltraFastFileSearch")
+        .set("FileDescription", "UFFS benchmark suite")
+        .set("CompanyName", "SKY, LLC.")
+        .set("LegalCopyright", "(c) 2025-2026 SKY, LLC. MPL-2.0.")
+        .set_manifest_file("../../assets/brand/app.manifest");
+    res.compile()
+        .expect("winresource: failed to embed uffs-bench resources");
+}
@@ -70,5 +70,11 @@ uffs-security.workspace = true
 # `--stop` commands — the same locale-proof primitive the updater uses.
 uffs-winsvc.workspace = true
 
+# Embeds the UFFS icon + version info + shared app.manifest into
+# `uffs-broker.exe` (see build.rs). A metadata-less binary is both unbranded
+# and a mild antivirus false-positive signal.
+[build-dependencies]
+winresource.workspace = true
+
 [lints]
 workspace = true
@@ -0,0 +1,46 @@
+// SPDX-License-Identifier: MPL-2.0
+// Copyright (c) 2025-2026 SKY, LLC.
+
+// Build scripts run on the build host, not the shipping binary's target, so the
+// workspace `deny(expect_used)` / `deny(unwrap_used)` runtime lints do not
+// apply here; panicking on a build-host failure (missing icon / no resource
+// compiler) is the idiomatic shape for a build script.
+#![allow(
+    clippy::expect_used,
+    reason = "build scripts may panic on build-host failure; workspace deny-expect targets runtime code"
+)]
+
+//! Build script for `uffs-broker`.
+//!
+//! Embeds Windows PE resources — the UFFS icon, version info (company, product,
+//! description), and the shared `app.manifest` — into `uffs-broker.exe` via
+//! [`winresource`](https://crates.io/crates/winresource), so the shipped binary
+//! carries proper metadata instead of shipping bare. A bare binary is both
+//! unbranded and a mild antivirus false-positive signal. MSVC-Windows only; a
+//! no-op on every other build target.
+
+fn main() {
+    println!("cargo:rerun-if-changed=build.rs");
+    println!("cargo:rerun-if-changed=../../assets/brand/icons/uffs.ico");
+    println!("cargo:rerun-if-changed=../../assets/brand/app.manifest");
+
+    let target_os = std::env::var("CARGO_CFG_TARGET_OS").unwrap_or_default();
+    let target_env = std::env::var("CARGO_CFG_TARGET_ENV").unwrap_or_default();
+    if target_os != "windows" || target_env != "msvc" {
+        return;
+    }
+
+    let mut res = winresource::WindowsResource::new();
+    res.set_icon("../../assets/brand/icons/uffs.ico")
+        .set("ProductName", "UltraFastFileSearch")
+        .set(
+            "FileDescription",
+            "UFFS Access Broker (elevated MFT handle service)",
+        )
+        .set("CompanyName", "SKY, LLC.")
+        .set("LegalCopyright", "(c) 2025-2026 SKY, LLC. MPL-2.0.")
+        .set("OriginalFilename", "uffs-broker.exe")
+        .set_manifest_file("../../assets/brand/app.manifest");
+    res.compile()
+        .expect("winresource: failed to embed uffs-broker resources");
+}
@@ -52,6 +52,21 @@ fn sc_output(output: &std::process::Output) -> String {
         .to_owned()
 }
 
+/// Print an in-progress step label without a trailing newline and flush, so
+/// the operator sees what a slow step (e.g. the blocking `sc start`) is doing
+/// before its "ok"/"failed" verdict lands on the same line.
+#[cfg(windows)]
+#[expect(
+    clippy::print_stdout,
+    reason = "CLI admin command — stdout is the user-visible result channel"
+)]
+fn print_step(label: &str) {
+    use std::io::Write as _;
+
+    print!("{label}");
+    let _flushed = std::io::stdout().flush();
+}
+
 /// Register the broker as an auto-start Windows Service and start it.
 ///
 /// # Why the argv is split the way it is
@@ -79,7 +94,11 @@ pub(super) fn install_service() -> anyhow::Result<()> {
         );
     }
 
+    // Step-by-step narration: `sc start` blocks until the service reports
+    // ready, which can take a minute — a silent wait reads as a hang.
     let exe = std::env::current_exe()?;
+    println!("Installing the UFFS Access Broker service...");
+    print_step("  registering the service (sc create)... ");
     let create = std::process::Command::new("sc.exe")
         .args([
             "create",
@@ -94,6 +113,7 @@ pub(super) fn install_service() -> anyhow::Result<()> {
         .output()?;
 
     if !create.status.success() {
+        println!("failed");
         // AUDIT-OK(bytes): `sc` output surfaced verbatim to the operator —
         // display only, no decision.
         anyhow::bail!(
@@ -102,21 +122,28 @@ pub(super) fn install_service() -> anyhow::Result<()> {
             sc_output(&create)
         );
     }
+    println!("ok");
 
     // Start it now so the broker is usable immediately — the whole point
     // is "no future UAC", which only holds once the service is running.
     // `start= auto` also brings it back on every boot.
+    print_step(
+        "  starting the service (Windows waits for it to report ready; \
+         this can take a minute)... ",
+    );
     let start = std::process::Command::new("sc.exe")
         .args(["start", SERVICE_NAME])
         .output()?;
 
     if start.status.success() {
+        println!("ok");
         println!(
             "UFFS Access Broker installed and started (auto-start on boot).\n\
              Non-elevated `uffs` searches will now use the broker for volume \
              access — no more UAC prompts."
         );
     } else {
+        println!("failed");
         // AUDIT-OK(bytes): `sc` output surfaced verbatim to the operator.
         println!(
             "Service installed (auto-start on boot), but starting it failed: \
 
@@ -99,6 +99,13 @@ fn main() {
     println!("cargo:rerun-if-changed=app.manifest");
     println!("cargo:rerun-if-changed=../../assets/brand/icons/uffs.ico");
 
+    // Stamp the short git commit (+ `-dirty`) into `UFFS_GIT_SHA` so
+    // `uffs --version` can tie a running binary back to the exact build —
+    // closing the "ran a stale binary" trap. The daemon already does this in its
+    // startup log; the CLI surfaced no commit, so a rebuilt-but-not-deployed
+    // uffs.exe was indistinguishable from the old one.
+    emit_git_sha();
+
     let target_os = std::env::var("CARGO_CFG_TARGET_OS").unwrap_or_default();
     let target_env = std::env::var("CARGO_CFG_TARGET_ENV").unwrap_or_default();
 
@@ -131,3 +138,33 @@ fn main() {
             .expect("winresource: failed to embed icon + manifest");
     }
 }
+
+/// Emit `UFFS_GIT_SHA` = the short `HEAD` commit, with a `-dirty` suffix when
+/// the working tree has uncommitted changes (so a hand-tweaked local build is
+/// never mistaken for the clean commit). Best-effort: `unknown` when git is
+/// absent. Mirrors `uffs-daemon`'s build stamp; `../../.git/HEAD` is watched so
+/// the stamp tracks the checked-out commit.
+fn emit_git_sha() {
+    use std::process::Command;
+
+    let sha = Command::new("git")
+        .args(["rev-parse", "--short", "HEAD"])
+        .output()
+        .ok()
+        .filter(|out| out.status.success())
+        .and_then(|out| String::from_utf8(out.stdout).ok())
+        .map(|raw| raw.trim().to_owned())
+        .filter(|trimmed| !trimmed.is_empty())
+        .unwrap_or_else(|| "unknown".to_owned());
+
+    let dirty = Command::new("git")
+        .args(["status", "--porcelain"])
+        .output()
+        .ok()
+        .filter(|out| out.status.success())
+        .is_some_and(|out| !out.stdout.is_empty());
+
+    let stamp = if dirty { format!("{sha}-dirty") } else { sha };
+    println!("cargo:rustc-env=UFFS_GIT_SHA={stamp}");
+    println!("cargo:rerun-if-changed=../../.git/HEAD");
+}
@@ -518,10 +518,18 @@ pub(crate) fn print_help() {
     print!("{HELP}");
 }
 
-/// Print version and exit.
+/// Print version and exit. Includes the build's short git commit (stamped by
+/// `build.rs` into `UFFS_GIT_SHA`, with `-dirty` for an uncommitted tree) so a
+/// running binary can be tied to the exact source it was built from — match it
+/// against `git rev-parse --short HEAD` to confirm you are not on a stale
+/// build.
 #[expect(clippy::print_stdout, reason = "intentional version output")]
 pub(crate) fn print_version() {
-    println!("uffs {}", env!("CARGO_PKG_VERSION"));
+    println!(
+        "uffs {} ({})",
+        env!("CARGO_PKG_VERSION"),
+        option_env!("UFFS_GIT_SHA").unwrap_or("unknown")
+    );
 }
 
 // ── Subcommand help texts ─────────────────────────────────────────────
 
@@ -16,6 +16,7 @@ pub mod aggregate;
 pub(crate) mod daemon_load;
 /// Daemon management subcommands.
 pub(crate) mod daemon_mgmt;
+pub(crate) mod daemon_status;
 /// Memory-tiering operator commands (`hibernate` / `preload`).
 ///
 /// Phase 8-B / 8-C — split off `daemon_mgmt` so each cluster stays