Extract pilot economy logic to shared module

- Move core trade, outfit, ship, and escort economic calculations from
  `PilotStore` to a new `PilotEconomy` type in `NovaSwiftStory`.
- Update `NovaSwiftStory` dependency graph to include `NovaSwiftEngine`.
- Add a cross-platform logging shim to `NovaSwiftStory` for non-Apple
  targets (Linux/Windows).
- Expose `PilotEconomy` to the Godot bridge for shared logic
  consistency.
- Miscellaneous UI adjustments for tvOS controller support.

Author: SirStig

Package.swift

@@ -31,7 +31,7 @@ let package = Package(
     targets: [
         .target(name: "NovaSwiftKit", path: "Sources/NovaSwiftKit"),
         .target(name: "NovaSwiftEngine", dependencies: ["NovaSwiftKit"], path: "Sources/NovaSwiftEngine"),
-        .target(name: "NovaSwiftStory", dependencies: ["NovaSwiftKit"], path: "Sources/NovaSwiftStory"),
+        .target(name: "NovaSwiftStory", dependencies: ["NovaSwiftKit", "NovaSwiftEngine"], path: "Sources/NovaSwiftStory"),
         .target(name: "NovaSwiftNet", path: "Sources/NovaSwiftNet"),
         .target(
             name: "NovaSwiftSync",

Sources/NovaSwiftStory/Logging.swift

@@ -1,12 +1,56 @@
+#if canImport(os)
 import os
+#endif
 
-/// Categorized `os.Logger`s for the mission/story runtime (control bits,
-/// missions, cron events, pilot persistence). View in Console.app/`log stream`
-/// filtered by `subsystem:com.novaswift.story`, or per-category with `category:<name>`.
+/// Categorized loggers for the mission/story runtime (control bits, missions,
+/// cron events, pilot persistence). On Apple platforms these are real
+/// `os.Logger`s (view in Console.app/`log stream` filtered by
+/// `subsystem:com.novaswift.story`, or per-category with `category:<name>`);
+/// off-Apple (Linux/Windows, e.g. the Godot bridge) they fall back to a tiny
+/// stderr-printing shim with the same call surface, since `os.Logger` doesn't
+/// exist there.
 public enum Log {
     static let subsystem = "com.novaswift.story"
 
+#if canImport(os)
     public static let mission = Logger(subsystem: subsystem, category: "Mission")
     public static let ncb = Logger(subsystem: subsystem, category: "NCB")
     public static let pilot = Logger(subsystem: subsystem, category: "Pilot")
+#else
+    public static let mission = FallbackLogger(category: "Mission")
+    public static let ncb = FallbackLogger(category: "NCB")
+    public static let pilot = FallbackLogger(category: "Pilot")
+#endif
 }
+
+#if !canImport(os)
+/// A string-interpolation type shaped like `os.Logger`'s `OSLogMessage` just
+/// enough that call sites written as `"...\(value, privacy: .public)"` — the
+/// house style throughout this codebase — keep compiling off-Apple without
+/// editing every call site. `privacy:` is accepted and ignored: there's no
+/// Console.app redaction story on Linux/Windows, so it always just interpolates.
+public struct LogMessage: ExpressibleByStringInterpolation, ExpressibleByStringLiteral, CustomStringConvertible {
+    public enum Privacy { case `public` }
+
+    public struct StringInterpolation: StringInterpolationProtocol {
+        var value = ""
+        public init(literalCapacity: Int, interpolationCount: Int) { value.reserveCapacity(literalCapacity) }
+        public mutating func appendLiteral(_ literal: String) { value += literal }
+        public mutating func appendInterpolation<T>(_ value: T) { self.value += "\(value)" }
+        public mutating func appendInterpolation<T>(_ value: T, privacy: Privacy) { self.value += "\(value)" }
+    }
+
+    public let description: String
+    public init(stringLiteral value: String) { description = value }
+    public init(stringInterpolation: StringInterpolation) { description = stringInterpolation.value }
+}
+
+/// Minimal stand-in for the subset of `os.Logger`'s API this module uses
+/// (`.debug`/`.notice`/`.error`). Prints to stderr.
+public struct FallbackLogger {
+    let category: String
+    public func debug(_ message: LogMessage) { FileHandle.standardError.write("[\(category)] \(message)\n".data(using: .utf8)!) }
+    public func notice(_ message: LogMessage) { FileHandle.standardError.write("[\(category)] \(message)\n".data(using: .utf8)!) }
+    public func error(_ message: LogMessage) { FileHandle.standardError.write("[\(category)] \(message)\n".data(using: .utf8)!) }
+}
+#endif

Sources/NovaSwiftStory/PilotEconomy.swift

@@ -4,6 +4,18 @@ import SwiftUI
 struct RootView: View {
     @EnvironmentObject private var model: AppModel
     @State private var menuAssets: MainMenuAssets?
+    #if os(tvOS)
+    /// Drives the controller-required gate: shows/hides live with pairing.
+    @ObservedObject private var padState = PadState.shared
+    /// Dev/automation escape hatch — the simulator has no way to pair a pad.
+    static let padGateDisabled: Bool = {
+        #if DEBUG
+        ProcessInfo.processInfo.environment["NOVASWIFT_NO_PAD_GATE"] != nil
+        #else
+        false
+        #endif
+    }()
+    #endif
 
     var body: some View {
         ZStack {
@@ -81,6 +93,19 @@ struct RootView: View {
             // click into any screen. Inert on tvOS / without a pad.
             ControllerCursorOverlay()
                 .zIndex(50)
+
+            #if os(tvOS)
+            // NovaSwift is controller-required on Apple TV (the Siri Remote
+            // can't fly a ship, and the whole UI is cursor-driven). Gate the
+            // app until an extended gamepad pairs; lifts itself the moment
+            // one connects. Matches the GCSupportedGameControllers Info.plist
+            // declaration (ExtendedGamepad only).
+            if !padState.isConnected, !Self.padGateDisabled {
+                ControllerRequiredView()
+                    .zIndex(60)
+                    .transition(.opacity)
+            }
+            #endif
         }
         .environment(\.novaDebugEnabled, model.settings.uiDebugOverlay)
         .environment(\.novaUIScale, model.settings.uiScale)   // "Overall UI scale"
@@ -190,3 +215,39 @@ struct RootView: View {
         model.commitSettings()
     }
 }
+#if os(tvOS)
+/// Full-screen "pair a controller" gate shown on Apple TV until an extended
+/// gamepad connects. NovaSwift is a twin-stick game with a cursor-driven UI —
+/// the Siri Remote genuinely can't play it, so this is shown up front rather
+/// than letting the player wander into an unusable menu.
+private struct ControllerRequiredView: View {
+    var body: some View {
+        ZStack {
+            Color.black.opacity(0.92).ignoresSafeArea()
+            VStack(spacing: 26) {
+                Image(systemName: "gamecontroller.fill")
+                    .font(.system(size: 96))
+                    .foregroundStyle(LinearGradient(colors: [.white, novaAmber],
+                                                    startPoint: .top, endPoint: .bottom))
+                Text("Connect a Game Controller")
+                    .novaFont(.title, weight: .bold, size: 34)
+                    .foregroundStyle(.white)
+                Text("NovaSwift needs a game controller — an Xbox, PlayStation, or other Bluetooth pad. The Siri Remote can't fly a starship.")
+                    .novaFont(.body, size: 20)
+                    .foregroundStyle(.secondary)
+                    .multilineTextAlignment(.center)
+                    .frame(maxWidth: 760)
+                    .fixedSize(horizontal: false, vertical: true)
+                Label("Pair one in Settings → Remotes & Devices → Bluetooth", systemImage: "dot.radiowaves.left.and.right")
+                    .novaFont(.caption, size: 17)
+                    .foregroundStyle(novaAmber)
+                ProgressView()
+                    .tint(novaAmber)
+                    .padding(.top, 6)
+            }
+            .padding(60)
+        }
+    }
+}
+#endif
+