feat(phase1): capability detection + install wizard

Implements Phase 1 of the build plan (1.1 + 1.2 + 1.3):

Design patterns:
- Strategy: BootstrapStrategy (GuiBootstrap / TuiBootstrap / HeadlessBootstrap)
  selected based on fs-info capability detection
- State Machine: WizardMachine drives 7 sequential steps with back-navigation

New modules:
- capability.rs     BootstrapCapability, BootstrapMode, DisplayEnv, ContainerRuntime
- error.rs          FsInitError
- keys.rs           FTL key constants with hardcoded English fallback
- store_clone.rs    clone_store() + default_store_dir() (extracted from main)
- strategy/         BootstrapStrategy trait + 3 impls
- wizard/           WizardStep trait + WizardMachine + 7 step structs

Wizard steps: Welcome → Capability → Engine → Bundle → Confirm → Progress → Done
Store path migrated: ~/.local/share/fsn/store → ~/.local/share/freesynergy/store
CLI: --clone-only flag added for non-interactive use
i18n: all user-facing strings as FTL key constants (keys.rs)

Author: FreeSynergy

Cargo.lock

@@ -9,5 +9,6 @@ name = "fs-init"
 path = "src/main.rs"
 
 [dependencies]
+fs-info = { path = "../fs-info" }
 gix = { version = "0.80", default-features = false, features = ["blocking-http-transport-reqwest-rust-tls", "worktree-mutation"] }
 clap = { version = "4", features = ["derive"] }

Cargo.toml

@@ -0,0 +1,146 @@
+//! Bootstrap capability detection via fs-info.
+//!
+//! Determines which display environment and terminal is available,
+//! and selects the appropriate `BootstrapMode` for the current system.
+
+use fs_info::{DetectedFeatures, Feature, FeatureDetect, OsInfo};
+
+// ── Display environment ───────────────────────────────────────────────────────
+
+/// Which graphical display server (if any) is active.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum DisplayEnv {
+    /// Wayland compositor is running.
+    Wayland,
+    /// X11 display server is running.
+    X11,
+    /// No display server — headless or SSH-only session.
+    None,
+}
+
+impl DisplayEnv {
+    fn from_features(features: &DetectedFeatures) -> Self {
+        if features.has(Feature::WaylandDisplay) {
+            DisplayEnv::Wayland
+        } else if features.has(Feature::X11Display) {
+            DisplayEnv::X11
+        } else {
+            DisplayEnv::None
+        }
+    }
+
+    /// Human-readable label for this display environment.
+    pub fn label(self) -> &'static str {
+        match self {
+            DisplayEnv::Wayland => "Wayland",
+            DisplayEnv::X11 => "X11",
+            DisplayEnv::None => "none (headless / SSH)",
+        }
+    }
+}
+
+// ── Bootstrap mode ────────────────────────────────────────────────────────────
+
+/// The bootstrap mode determines which UI the wizard runs in.
+///
+/// All modes currently use the same CLI-based wizard (plain text output +
+/// stdin input) because the render engine has not been installed yet.
+/// The mode controls which bundles are pre-selected and what is launched
+/// after installation completes.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum BootstrapMode {
+    /// Display server is available — GUI engine will be installed.
+    Gui,
+    /// No display server, but an interactive terminal is present — TUI mode.
+    Tui,
+    /// No display server and no interactive terminal — API + CLI only.
+    Headless,
+}
+
+impl BootstrapMode {
+    /// Human-readable label.
+    pub fn label(self) -> &'static str {
+        match self {
+            BootstrapMode::Gui => "GUI",
+            BootstrapMode::Tui => "TUI",
+            BootstrapMode::Headless => "Headless (API + CLI only)",
+        }
+    }
+}
+
+// ── Container runtime ─────────────────────────────────────────────────────────
+
+/// Which container runtime is available.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum ContainerRuntime {
+    Podman,
+    Docker,
+    None,
+}
+
+impl ContainerRuntime {
+    fn from_features(features: &DetectedFeatures) -> Self {
+        if features.has(Feature::Podman) {
+            ContainerRuntime::Podman
+        } else if features.has(Feature::Docker) {
+            ContainerRuntime::Docker
+        } else {
+            ContainerRuntime::None
+        }
+    }
+
+    /// Human-readable label.
+    pub fn label(self) -> &'static str {
+        match self {
+            ContainerRuntime::Podman => "Podman",
+            ContainerRuntime::Docker => "Docker",
+            ContainerRuntime::None => "none detected",
+        }
+    }
+}
+
+// ── Bootstrap capability ──────────────────────────────────────────────────────
+
+/// All system capabilities relevant to bootstrapping.
+pub struct BootstrapCapability {
+    /// OS information (name, version, arch, hostname).
+    pub os: OsInfo,
+    /// Active display environment.
+    pub display: DisplayEnv,
+    /// Whether stdin is an interactive terminal.
+    pub has_terminal: bool,
+    /// Available container runtime.
+    pub container: ContainerRuntime,
+    /// Derived bootstrap mode.
+    pub mode: BootstrapMode,
+}
+
+impl BootstrapCapability {
+    /// Detect all capabilities from the live system.
+    pub fn detect() -> Self {
+        let features = FeatureDetect::run();
+        let os = OsInfo::detect();
+        let display = DisplayEnv::from_features(&features);
+        let has_terminal = features.has_terminal();
+        let container = ContainerRuntime::from_features(&features);
+        let mode = derive_mode(display, has_terminal);
+
+        BootstrapCapability {
+            os,
+            display,
+            has_terminal,
+            container,
+            mode,
+        }
+    }
+}
+
+fn derive_mode(display: DisplayEnv, has_terminal: bool) -> BootstrapMode {
+    if display != DisplayEnv::None {
+        BootstrapMode::Gui
+    } else if has_terminal {
+        BootstrapMode::Tui
+    } else {
+        BootstrapMode::Headless
+    }
+}

src/capability.rs

@@ -0,0 +1,39 @@
+//! Error type for fs-init.
+
+use std::fmt;
+
+/// All errors that can occur during bootstrap.
+#[derive(Debug)]
+pub enum FsInitError {
+    /// Store clone failed.
+    StoreClone(String),
+    /// I/O error (stdin/stdout).
+    Io(std::io::Error),
+    /// User aborted the wizard.
+    Aborted,
+}
+
+impl fmt::Display for FsInitError {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        match self {
+            FsInitError::StoreClone(msg) => write!(f, "Store clone failed: {msg}"),
+            FsInitError::Io(e) => write!(f, "I/O error: {e}"),
+            FsInitError::Aborted => write!(f, "Aborted by user"),
+        }
+    }
+}
+
+impl std::error::Error for FsInitError {
+    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
+        match self {
+            FsInitError::Io(e) => Some(e),
+            _ => None,
+        }
+    }
+}
+
+impl From<std::io::Error> for FsInitError {
+    fn from(e: std::io::Error) -> Self {
+        FsInitError::Io(e)
+    }
+}

src/error.rs

@@ -0,0 +1,118 @@
+//! FTL key constants with hardcoded English fallback values.
+//!
+//! Every user-facing string must be declared here.
+//! The FTL key name is documented in the comment above each constant.
+//! The value is the English fallback embedded in the binary.
+//! When fs-i18n is available at runtime, the FTL key is used instead.
+
+// ── General ───────────────────────────────────────────────────────────────────
+
+/// FTL key: `init-title`
+pub const INIT_TITLE: &str = "FreeSynergy Init";
+
+/// FTL key: `init-version`
+pub const INIT_DIVIDER: &str = "────────────────────────────────────────────────";
+
+/// FTL key: `init-abort-hint`
+pub const INIT_ABORT_HINT: &str = "Press Ctrl+C at any time to abort.";
+
+/// FTL key: `init-prompt-continue`
+pub const INIT_PROMPT_CONTINUE: &str = "Press Enter to continue…";
+
+/// FTL key: `init-prompt-choice`
+pub const INIT_PROMPT_CHOICE: &str = "Enter number: ";
+
+/// FTL key: `init-invalid-choice`
+pub const INIT_INVALID_CHOICE: &str = "Invalid choice. Please try again.";
+
+// ── Capability detection ──────────────────────────────────────────────────────
+
+/// FTL key: `init-detecting-capabilities`
+pub const INIT_DETECTING_CAPABILITIES: &str = "Detecting system capabilities…";
+
+/// FTL key: `init-capability-os`
+pub const INIT_CAPABILITY_OS: &str = "  OS:             ";
+
+/// FTL key: `init-capability-arch`
+pub const INIT_CAPABILITY_ARCH: &str = "  Architecture:   ";
+
+// ── Wizard steps ──────────────────────────────────────────────────────────────
+
+/// FTL key: `init-step-welcome-title`
+pub const INIT_STEP_WELCOME_TITLE: &str = "Welcome";
+
+/// FTL key: `init-step-welcome-body`
+pub const INIT_STEP_WELCOME_BODY: &str =
+    "This wizard will guide you through installing FreeSynergy on this node.\n\
+     It will clone the official store and help you choose what to install.";
+
+/// FTL key: `init-step-capability-title`
+pub const INIT_STEP_CAPABILITY_TITLE: &str = "System Capabilities";
+
+/// FTL key: `init-step-engine-title`
+pub const INIT_STEP_ENGINE_TITLE: &str = "Render Engine";
+
+/// FTL key: `init-step-engine-prompt`
+pub const INIT_STEP_ENGINE_PROMPT: &str = "Choose the render engine for the desktop UI.\n\
+     (Only relevant if you install a bundle with a desktop.)";
+
+/// FTL key: `init-step-bundle-title`
+pub const INIT_STEP_BUNDLE_TITLE: &str = "Bundle Selection";
+
+/// FTL key: `init-step-bundle-prompt`
+pub const INIT_STEP_BUNDLE_PROMPT: &str = "Choose a bundle to install:";
+
+/// FTL key: `init-step-confirm-title`
+pub const INIT_STEP_CONFIRM_TITLE: &str = "Confirm Installation";
+
+/// FTL key: `init-step-confirm-bundle`
+pub const INIT_STEP_CONFIRM_BUNDLE: &str = "  Bundle:          ";
+
+/// FTL key: `init-step-confirm-engine`
+pub const INIT_STEP_CONFIRM_ENGINE: &str = "  Render engine:   ";
+
+/// FTL key: `init-step-confirm-target`
+pub const INIT_STEP_CONFIRM_TARGET: &str = "  Install target:  ";
+
+/// FTL key: `init-step-confirm-question`
+pub const INIT_STEP_CONFIRM_QUESTION: &str = "Proceed? [y/N]: ";
+
+/// FTL key: `init-step-progress-title`
+pub const INIT_STEP_PROGRESS_TITLE: &str = "Installing";
+
+/// FTL key: `init-step-progress-cloning-store`
+pub const INIT_STEP_PROGRESS_CLONING_STORE: &str = "  Cloning store catalog…";
+
+/// FTL key: `init-step-progress-clone-ok`
+pub const INIT_STEP_PROGRESS_CLONE_OK: &str = "  Store ready.";
+
+/// FTL key: `init-step-progress-clone-exists`
+pub const INIT_STEP_PROGRESS_CLONE_EXISTS: &str = "  Store already present — skipping clone.";
+
+/// FTL key: `init-step-progress-install-pending`
+pub const INIT_STEP_PROGRESS_INSTALL_PENDING: &str =
+    "  Package install pipeline not yet available (Phase 2).";
+
+/// FTL key: `init-step-done-title`
+pub const INIT_STEP_DONE_TITLE: &str = "Done";
+
+/// FTL key: `init-step-done-body`
+pub const INIT_STEP_DONE_BODY: &str = "FreeSynergy has been bootstrapped.\n\
+     The store is available locally. Start the Store service to continue.";
+
+/// FTL key: `init-step-done-store-path`
+pub const INIT_STEP_DONE_STORE_PATH: &str = "  Store path:      ";
+
+// ── Target ────────────────────────────────────────────────────────────────────
+
+/// FTL key: `init-target-container`
+pub const INIT_TARGET_CONTAINER: &str = "Container (Podman / Docker)";
+
+/// FTL key: `init-target-rpm`
+pub const INIT_TARGET_RPM: &str = "RPM package";
+
+/// FTL key: `init-target-deb`
+pub const INIT_TARGET_DEB: &str = "DEB package";
+
+/// FTL key: `init-target-appimage`
+pub const INIT_TARGET_APPIMAGE: &str = "AppImage";