Add install-shell-completions command, show version on bare run, update README

- New install-shell-completions command: auto-detects zsh/bash, installs
  completion script, configures shell rc files (idempotent)
- Running asc-client without a subcommand now shows version + help
- README: add Homebrew tap, download binary, and quarantine instructions;
  clarify build time is due to asc-swift's generated API files

Sources/asc-client/ASCClient.swift

@@ -6,6 +6,11 @@ struct ASCClient: AsyncParsableCommand {
     commandName: "asc-client",
     abstract: "A command-line tool for the App Store Connect API.",
     version: "0.1.0",
-    subcommands: [ConfigureCommand.self, AppsCommand.self, BuildsCommand.self]
+    subcommands: [ConfigureCommand.self, AppsCommand.self, BuildsCommand.self, InstallCompletionsCommand.self]
   )
+
+  func run() async throws {
+    print("asc-client \(Self.configuration.version)")
+    print(Self.helpMessage())
+  }
 }

Sources/asc-client/Commands/InstallCompletionsCommand.swift

@@ -0,0 +1,138 @@
+import ArgumentParser
+import Foundation
+
+struct InstallCompletionsCommand: ParsableCommand {
+  static let configuration = CommandConfiguration(
+    commandName: "install-shell-completions",
+    abstract: "Install shell completions for asc-client."
+  )
+
+  func run() throws {
+    guard let shell = ProcessInfo.processInfo.environment["SHELL"] else {
+      throw ValidationError("Cannot detect shell. Set the SHELL environment variable.")
+    }
+
+    let home = FileManager.default.homeDirectoryForCurrentUser
+    let fm = FileManager.default
+
+    if shell.hasSuffix("/zsh") {
+      try installZsh(home: home, fm: fm)
+    } else if shell.hasSuffix("/bash") {
+      try installBash(home: home, fm: fm)
+    } else {
+      throw ValidationError(
+        "Only zsh and bash are supported. Detected: \(shell)")
+    }
+
+    print()
+    print("Done. Restart your shell or run: source ~/.\(shell.hasSuffix("/zsh") ? "zshrc" : "bashrc")")
+  }
+
+  private func installZsh(home: URL, fm: FileManager) throws {
+    // 1. Create ~/.zfunc if needed
+    let zfuncDir = home.appendingPathComponent(".zfunc")
+    if !fm.fileExists(atPath: zfuncDir.path) {
+      try fm.createDirectory(at: zfuncDir, withIntermediateDirectories: true)
+      print("Created \(zfuncDir.path)/")
+    } else {
+      print("\(zfuncDir.path)/ already exists.")
+    }
+
+    // 2. Write completion script
+    let completionScript = ASCClient.completionScript(for: .zsh)
+    let completionFile = zfuncDir.appendingPathComponent("_asc-client")
+    try completionScript.write(to: completionFile, atomically: true, encoding: .utf8)
+    print("Installed completion script to \(completionFile.path)")
+
+    // 3. Ensure ~/.zshrc_local has fpath and compinit
+    let zshrcLocal = home.appendingPathComponent(".zshrc_local")
+    var localContents = ""
+    if fm.fileExists(atPath: zshrcLocal.path) {
+      localContents = try String(contentsOf: zshrcLocal, encoding: .utf8)
+    }
+
+    let fpathLine = "fpath=(~/.zfunc $fpath)"
+    let compinitLine = "autoload -Uz compinit && compinit"
+    var localModified = false
+
+    if !localContents.contains(fpathLine) {
+      let block = "\n# asc-client completions\n\(fpathLine)\n\(compinitLine)\n"
+      localContents += block
+      localModified = true
+    } else if !localContents.contains(compinitLine) {
+      localContents = localContents.replacingOccurrences(
+        of: fpathLine, with: "\(fpathLine)\n\(compinitLine)")
+      localModified = true
+    }
+
+    if localModified {
+      try localContents.write(to: zshrcLocal, atomically: true, encoding: .utf8)
+      print("Updated \(zshrcLocal.path)")
+    } else {
+      print("\(zshrcLocal.path) already configured.")
+    }
+
+    // 4. Ensure ~/.zshrc sources ~/.zshrc_local
+    try ensureSourceLine(
+      rcFile: home.appendingPathComponent(".zshrc"),
+      sourceLine: "source ~/.zshrc_local",
+      fm: fm
+    )
+  }
+
+  private func installBash(home: URL, fm: FileManager) throws {
+    // 1. Create ~/.bash_completions if needed
+    let completionsDir = home.appendingPathComponent(".bash_completions")
+    if !fm.fileExists(atPath: completionsDir.path) {
+      try fm.createDirectory(at: completionsDir, withIntermediateDirectories: true)
+      print("Created \(completionsDir.path)/")
+    } else {
+      print("\(completionsDir.path)/ already exists.")
+    }
+
+    // 2. Write completion script
+    let completionScript = ASCClient.completionScript(for: .bash)
+    let completionFile = completionsDir.appendingPathComponent("asc-client.bash")
+    try completionScript.write(to: completionFile, atomically: true, encoding: .utf8)
+    print("Installed completion script to \(completionFile.path)")
+
+    // 3. Ensure ~/.bashrc_local sources the completion script
+    let bashrcLocal = home.appendingPathComponent(".bashrc_local")
+    var localContents = ""
+    if fm.fileExists(atPath: bashrcLocal.path) {
+      localContents = try String(contentsOf: bashrcLocal, encoding: .utf8)
+    }
+
+    let sourceLine = "source ~/.bash_completions/asc-client.bash"
+    if !localContents.contains(sourceLine) {
+      localContents += "\n# asc-client completions\n\(sourceLine)\n"
+      try localContents.write(to: bashrcLocal, atomically: true, encoding: .utf8)
+      print("Updated \(bashrcLocal.path)")
+    } else {
+      print("\(bashrcLocal.path) already configured.")
+    }
+
+    // 4. Ensure ~/.bashrc sources ~/.bashrc_local
+    try ensureSourceLine(
+      rcFile: home.appendingPathComponent(".bashrc"),
+      sourceLine: "[ -f ~/.bashrc_local ] && source ~/.bashrc_local",
+      fm: fm
+    )
+  }
+
+  private func ensureSourceLine(rcFile: URL, sourceLine: String, fm: FileManager) throws {
+    if fm.fileExists(atPath: rcFile.path) {
+      let contents = try String(contentsOf: rcFile, encoding: .utf8)
+      if !contents.contains(sourceLine) {
+        let newContents = sourceLine + "\n" + contents
+        try newContents.write(to: rcFile, atomically: true, encoding: .utf8)
+        print("Updated \(rcFile.path)")
+      } else {
+        print("\(rcFile.path) already configured.")
+      }
+    } else {
+      try (sourceLine + "\n").write(to: rcFile, atomically: true, encoding: .utf8)
+      print("Created \(rcFile.path)")
+    }
+  }
+}