Cross-platform build portability

[valentina2509]

Cross-platform build portability

This is a tracking issue for defects that cause build or runtime failures on
specific platforms (Linux, macOS, aarch64) due to missing platform guards in
the build configuration.

Child issues

Issue	Locus	Status
#43 — windows-sys not target-gated	lore-client:21, lore:32, lore-base:37, lore-revision:61 Cargo.toml	PR #45 open
#30 — CLI mojibake in lore history on Windows	lore-client/src/cli/terminal_size.rs, print_macros.rs	No PR
#42 — aarch64 runtime crash after self-compile	lore-base/build.rs:28–29 (-mcpu=neoverse-512tvb)	Pending classification

Shared pattern

Each item results from a build-time or startup configuration that lacks a
platform guard, causing failure on platforms outside the intended target.

windows-sys gating (#43):
lore-storage/Cargo.toml:47–48 and lore-credential/Cargo.toml:28–29 are
the correct reference: [target.'cfg(target_os = "windows")'.dependencies].
Four crates declare windows-sys as an unconditional dependency, adding a
Windows-only transitive dependency to non-Windows builds. PR #45 is open.

CLI mojibake (#30):
The Windows console defaults to a legacy code page on many configurations.
Adding SetConsoleOutputCP(CP_UTF8) under #[cfg(target_os = "windows")] at
CLI startup is the standard fix.

aarch64 crash (#42):
lore-base/build.rs:28–29 passes -mcpu=neoverse-512tvb unconditionally to
the C compiler. The Neoverse 512TVB microarch enables SVE2 and other
extensions not available on all aarch64 hardware. Binaries compiled with this
flag crash with illegal hardware instruction on hardware that does not
implement those extensions. The flag should be gated on a CPU-capability check
or a cargo:warning= should alert the user that their hardware does not
support this build path.

Fix directions

• Merge PR Gate windows-sys dependencies on Windows targets and fix UTF-8 terminal output #45 for windows-sys gating; verify that the Win32_* feature
  subsets differ per crate and update each independently.
• Add SetConsoleOutputCP(CP_UTF8) at CLI startup on Windows (can be
  included in PR Gate windows-sys dependencies on Windows targets and fix UTF-8 terminal output #45 or a follow-up PR).
• Investigate lore-base/build.rs:28–29 and gate the microarch flag
  appropriately for the aarch64 target.

Background

Identified in the open-bug theme analysis (triage/2026-06-bug-theme-analysis.md,
branch valentina2509:docs/bug-theme-analysis).

[subhramit]

Hey @valentina2509, it felt more convenient to take the opportunity and extend the scope of #45 to add the fix for #30 there itself rather than doing it as a follow-up, as I needed to add a new Win32_Globalization dependency in the client, in a line I was already touching.

cc @mjansson who was the initial reviewer.

I'm taking a look at #42 in the meanwhile.

Update - Have filed #82 for #42.

[subhramit]

@mjansson @ragnarula /
@valentina2509 @ayyyee @matt-hoffman-epic @peter-lockhart-pub /
@fhmlopez @hmuurine
Just want to confirm - is this project still actively open to external contributions? Or is it a mirror? I only see maintainer commits in the project. Am I asking for feedback at the right place?

[mjansson]

Epic folks are on summer break this week, PR intake and merging will start when we're all back next week