Fix #145: Code migration and environment configuration updates

Implements all 6 child issues grouped under #145:
- #76: Add triggerTrackingPermissionsRequest environment property
- #106: Migrate SigVerifier.findVerification extension from Bushel
- #110: Add NSError extensions for file error checking
- #127: Migrate ConsoleOutput with stderr routing from BushelCloud
- #131: Enable AllPublicDeclarationsHaveDocumentation rule
- #132: Fix VS Code launch.json with standard LLDB fields

All new code includes proper documentation and tests pass.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: leogdion

.swift-format

@@ -24,7 +24,7 @@
   "reflowMultilineStringLiterals" : "never",
   "respectsExistingLineBreaks" : true,
   "rules" : {
-    "AllPublicDeclarationsHaveDocumentation" : false,
+    "AllPublicDeclarationsHaveDocumentation" : true,
     "AlwaysUseLiteralForEmptyCollectionInit" : false,
     "AlwaysUseLowerCamelCase" : true,
     "AmbiguousTrailingClosureOverload" : true,

.vscode/launch.json

@@ -3,22 +3,24 @@
         {
             "type": "swift",
             "request": "launch",
-            "args": [],
-            "cwd": "${workspaceFolder:BushelKit}",
             "name": "Debug bushel",
+            "program": "${workspaceFolder}/.build/debug/bushel",
+            "args": [],
+            "cwd": "${workspaceFolder}",
             "preLaunchTask": "swift: Build Debug bushel",
-            "target": "bushel",
-            "configuration": "debug"
+            "stopOnEntry": false,
+            "terminal": "console"
         },
         {
             "type": "swift",
             "request": "launch",
-            "args": [],
-            "cwd": "${workspaceFolder:BushelKit}",
             "name": "Release bushel",
+            "program": "${workspaceFolder}/.build/release/bushel",
+            "args": [],
+            "cwd": "${workspaceFolder}",
             "preLaunchTask": "swift: Build Release bushel",
-            "target": "bushel",
-            "configuration": "release"
+            "stopOnEntry": false,
+            "terminal": "console"
         }
     ]
 }

Package.swift

@@ -4346,7 +4346,7 @@ struct FelinePine: PackageDependency, TargetDependency {
 
 struct RadiantKit: PackageDependency, TargetDependency {
   var dependency: Package.Dependency {
-    .package(url: "https://github.com/brightdigit/RadiantKit.git", from: "1.0.0-beta.4")
+    .package(url: "https://github.com/brightdigit/RadiantKit.git", from: "1.0.0-beta.5")
   }
 }
 //

Sources/BushelFoundation/EnvironmentConfiguration.swift

@@ -44,9 +44,14 @@ public struct EnvironmentConfiguration: CustomReflectable, Sendable {
     /// Resets the application.
     case resetApplication = "RESET_APPLICATION"
 
+    /// Indicates whether this is a release version.
     case releaseVersion = "RELEASE_VERSION"
 
+    /// The threshold of user engagement to trigger a review request.
     case reviewEngagementThreshold = "REVIEW_ENGAGEMENT_THRESHOLD"
+
+    /// Indicates whether to trigger tracking permissions request.
+    case triggerTrackingPermissionsRequest = "TRIGGER_TRACKING_PERMISSIONS_REQUEST"
   }
 
   /// The shared instance of `EnvironmentConfiguration`.
@@ -76,6 +81,10 @@ public struct EnvironmentConfiguration: CustomReflectable, Sendable {
   @EnvironmentProperty(Key.reviewEngagementThreshold)
   public var reviewEngagementThreshold: Int
 
+  /// Indicates whether to trigger tracking permissions request.
+  @EnvironmentProperty(Key.triggerTrackingPermissionsRequest)
+  public var triggerTrackingPermissionsRequest: Bool
+
   /// Provides a custom mirror for the `EnvironmentConfiguration` instance.
   public var customMirror: Mirror {
     Mirror(
@@ -87,6 +96,7 @@ public struct EnvironmentConfiguration: CustomReflectable, Sendable {
         "resetApplication": self.resetApplication,
         "releaseVersion": self.releaseVersion,
         "reviewEngagementThreshold": self.reviewEngagementThreshold,
+        "triggerTrackingPermissionsRequest": self.triggerTrackingPermissionsRequest,
       ]
     )
   }

Sources/BushelFoundation/SigVerification/SigVerifier+FindVerification.swift

@@ -0,0 +1,48 @@
+//
+//  SigVerifier+FindVerification.swift
+//  BushelKit
+//
+//  Created by Leo Dion.
+//  Copyright © 2025 BrightDigit.
+//
+//  Permission is hereby granted, free of charge, to any person
+//  obtaining a copy of this software and associated documentation
+//  files (the "Software"), to deal in the Software without
+//  restriction, including without limitation the rights to use,
+//  copy, modify, merge, publish, distribute, sublicense, and/or
+//  sell copies of the Software, and to permit persons to whom the
+//  Software is furnished to do so, subject to the following
+//  conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+//  OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+//  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+//  WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+//  OTHER DEALINGS IN THE SOFTWARE.
+//
+
+extension SigVerifier {
+  /// Attempts to find verification for a signature source, returning nil if not found.
+  ///
+  /// This is a convenience wrapper around `isSignatureSigned(from:)` that treats
+  /// the `.notFound` error case as a `nil` result instead of throwing.
+  ///
+  /// - Parameter source: The source of the signature to be verified.
+  /// - Returns: The signature verification if found, or `nil` if not found.
+  /// - Throws: A `SigVerificationError` if verification fails for reasons other than not found.
+  public func findVerification(for source: SignatureSource) async throws(SigVerificationError)
+    -> SigVerification?
+  {
+    do {
+      return try await self.isSignatureSigned(from: source)
+    } catch SigVerificationError.notFound {
+      return nil
+    }
+  }
+}

Sources/BushelUtilities/ConsoleOutput.swift

@@ -34,45 +34,47 @@ import Foundation
 /// Provides user-facing console output with verbose mode support.
 /// This is separate from logging, which is used for debugging and monitoring.
 ///
-/// ## Thread Safety
-/// The `isVerbose` flag uses `nonisolated(unsafe)` because:
-/// - It's set exactly once at application startup before any concurrent access
-/// - It's only read thereafter (no writes during concurrent execution)
-/// - This pattern is safe for CLI tools with single initialization phase
-///
-/// **Important**: Do not modify `isVerbose` after concurrent operations begin.
+/// **Important**: All output goes to stderr to keep stdout clean for structured output (JSON, etc.)
 public enum ConsoleOutput {
   /// Global verbose mode flag
   ///
-  /// Set this flag during application initialization, before any async operations.
-  /// Once set, it should only be read, never written.
+  /// Note: This is marked with `nonisolated(unsafe)` because it's set once at startup
+  /// before any concurrent access and then only read. This pattern is safe for CLI tools.
   nonisolated(unsafe) public static var isVerbose = false
 
+  /// Print to stderr (keeping stdout clean for structured output)
+  ///
+  /// This is a drop-in replacement for Swift's `print()` that writes to stderr instead of stdout.
+  /// Use this throughout the codebase to ensure JSON output on stdout remains clean.
+  public static func print(_ message: String) {
+    if let data = (message + "\n").data(using: .utf8) {
+      FileHandle.standardError.write(data)
+    }
+  }
+
   /// Print verbose message only when verbose mode is enabled
   public static func verbose(_ message: String) {
-    guard isVerbose else {
-      return
-    }
-    print("  \(message)")
+    guard isVerbose else { return }
+    ConsoleOutput.print("  \(message)")
   }
 
   /// Print standard informational message
   public static func info(_ message: String) {
-    print(message)
+    ConsoleOutput.print(message)
   }
 
   /// Print success message
   public static func success(_ message: String) {
-    print("  ✓ \(message)")
+    ConsoleOutput.print("  ✓ \(message)")
   }
 
   /// Print warning message
   public static func warning(_ message: String) {
-    print("  ⚠️  \(message)")
+    ConsoleOutput.print("  ⚠️  \(message)")
   }
 
   /// Print error message
   public static func error(_ message: String) {
-    print("  ❌ \(message)")
+    ConsoleOutput.print("  ❌ \(message)")
   }
 }

Sources/BushelUtilities/Extensions/FileManager+Errors.swift

@@ -59,3 +59,20 @@ extension Error where Self == NSError {
     )
   }
 }
+
+extension NSError {
+  /// Indicates whether the error is a file not found error.
+  public var isFileNotFound: Bool {
+    domain == NSCocoaErrorDomain && code == NSFileNoSuchFileError
+  }
+
+  /// Indicates whether the error is a corrupt file error.
+  public var isCorruptFile: Bool {
+    domain == NSCocoaErrorDomain && code == NSFileReadCorruptFileError
+  }
+
+  /// Indicates whether the error is a file not found or corrupt file error.
+  public var isFileNotFoundOrCorrupt: Bool {
+    isFileNotFound || isCorruptFile
+  }
+}