Update documentation imports and formatting

Standardized import order in documentation examples to import CommonProcessExecutionKit before CommonShell. Improved code formatting and spacing for better readability in code snippets across multiple documentation files.

Author: rismay

README.md

@@ -24,7 +24,7 @@ import CommonShell
 
 var shell = CommonShell(executable: .name("git"))
 shell.hostKind = .env(options: [])
-let out = try await shell.run(arguments: ["status"]) // throws on non-zero exit
+let out = try await shell.run(arguments: ["status"])  // throws on non-zero exit
 print(out)
 ```
 
@@ -62,7 +62,7 @@ public struct CommandSpec: Codable, Sendable {
   public var hostKind: ExecutionHostKind? = nil
   public var runnerKind: ProcessRunnerKind? = nil
   public var timeout: Duration? = nil
-  public var instrumentation: ProcessInstrumentation? = nil // runtime-only
+  public var instrumentation: ProcessInstrumentation? = nil  // runtime-only
 }
 ```
 

SPEC.md

@@ -96,8 +96,8 @@
 ### Examples
 
 ```swift
-import CommonShell
 import CommonProcessExecutionKit
+import CommonShell
 
 let sh = CommonShell(executable: Executable.path("/usr/bin/env"))
 

sources/common-shell-arguments/CommonShellArguments.docc/CommonShellArguments.md

@@ -23,7 +23,7 @@ struct MyCLI: AsyncParsableCommand, CommonShellParsableArguments {
       host: .shell(options: []),
       identity: .path("/bin/sh"),
       args: ["echo hello"]
-    ) // via shell wrapper
+    )  // via shell wrapper
     print(out)
   }
 }

sources/common-shell/CommonShell.docc/QuickStart.md

@@ -9,8 +9,8 @@ unified `ExecutableReference` and `Executable` (from CommonProcess) to express
 what you want to run and keep wrapper policy at the shell layer.
 
 ```swift
-import CommonShell
 import CommonProcessExecutionKit
+import CommonShell
 
 // A neutral base configured to use /usr/bin/env by default
 let shell = CommonShell(executable: Executable.path("/usr/bin/env"))
@@ -73,14 +73,17 @@ host-aware helpers:
 
 ```swift
 // Shell host convenience with override identity
-print(try await shell.run(host: .shell(options: []), identity: .path("/bin/sh"), args: ["echo via shell"]))
+print(
+  try await shell.run(
+    host: .shell(options: []), identity: .path("/bin/sh"), args: ["echo via shell"]))
 
 // Env host with explicit options via the low-level API
-print(try await shell.run(
-  host: .env(options: ["-n"]),
-  executable: Executable.name("echo"),
-  arguments: ["ok"]
-))
+print(
+  try await shell.run(
+    host: .env(options: ["-n"]),
+    executable: Executable.name("echo"),
+    arguments: ["ok"]
+  ))
 ```
 
 ## Duration benchmarks

sources/common-shell/CommonShell.docc/RunnersAndRoutes.md

@@ -14,8 +14,8 @@ CommonProcess provides multiple runner backends (availability depends on platfor
 Pick explicitly on any CommonShell `run`/`runForInterval` via `runnerKind:`:
 
 ```swift
-import CommonShell
 import CommonProcessExecutionKit
+import CommonShell
 
 let sh = CommonShell(executable: Executable.path("/usr/bin/env"))
 let out = try await sh.run(

sources/common-shell/CommonShell.docc/WhatsNew.md

@@ -11,8 +11,8 @@ A quick note on the simplified CommonShell API.
 ## Examples
 
 ```swift
-import CommonShell
 import CommonProcessExecutionKit
+import CommonShell
 
 let sh = CommonShell(executable: .path("/usr/bin/env"))
 

sources/common-shell/Documentation.docc/CommonShell-Comparison-TuistCommand.md

@@ -38,7 +38,7 @@ print(out.utf8Output())
 
 // Streaming run (consume events)
 let (events, cancel) = try shell.stream(["log", "--oneline"])
-for try await e in events { /* .stdout/.stderr/.completed */ }
+for try await e in events { /* .stdout/.stderr/.completed */  }
 
 // Host wrappers (env/shell/npx/npm) set Invocation.hostKind appropriately
 let envOut = try await shell.runEnv(["PATH"])  // runs env PATH