Merge branch 'feature/ci' into development

Author: keypair34

.agents/skills/ci-cd/SKILL.md

@@ -260,16 +260,16 @@ The PyPI workflow is also exempt because maturin is already pointed at the right
 
 ### Current runners and targets
 
-| Platform      | Runner             | Target                      | Notes                     |
-| ------------- | ------------------ | --------------------------- | ------------------------- |
-| Linux x86_64  | `ubuntu-latest`    | `x86_64-unknown-linux-gnu`  | Native                    |
-| Linux arm64   | `ubuntu-24.04-arm` | `aarch64-unknown-linux-gnu` | Native — do not use QEMU  |
-| Windows x64   | `windows-2022`     | `x86_64-pc-windows-msvc`    | Native                    |
-| Windows arm64 | `windows-2022`     | `aarch64-pc-windows-msvc`   | Cross-compile on x64 host |
-| macOS x64     | `macos-15-intel`   | `x86_64-apple-darwin`       | Native Intel runner       |
-| macOS arm64   | `macos-latest`     | `aarch64-apple-darwin`      | Native Apple Silicon      |
+| Platform      | Runner             | Target                      | Notes                      |
+| ------------- | ------------------ | --------------------------- | -------------------------- |
+| Linux x86_64  | `ubuntu-latest`    | `x86_64-unknown-linux-gnu`  | Native                     |
+| Linux arm64   | `ubuntu-24.04-arm` | `aarch64-unknown-linux-gnu` | Native — do not use QEMU   |
+| Windows x64   | `windows-2022`     | `x86_64-pc-windows-msvc`    | Native                     |
+| Windows arm64 | `windows-2022`     | `aarch64-pc-windows-msvc`   | Do not use for PyPI wheels |
+| macOS x64     | `macos-15-intel`   | `x86_64-apple-darwin`       | Native Intel runner        |
+| macOS arm64   | `macos-latest`     | `aarch64-apple-darwin`      | Native Apple Silicon       |
 
-For npm and GitHub Release, use native runners. For PyPI (maturin), the macOS x64 build uses `macos-latest` with cross-compilation because maturin handles it transparently inside its container.
+For npm and GitHub Release, use native runners. For PyPI (maturin), the macOS x64 build uses `macos-latest` with cross-compilation because maturin handles it transparently inside its container. Windows arm64 is the exception: GitHub's hosted Windows runners only provide x64 Python, so maturin will refuse to build an `aarch64-pc-windows-msvc` wheel when the interpreter reports `win-amd64`.
 
 ### Do not use QEMU for arm64 Linux
 
@@ -708,6 +708,9 @@ This reads whatever version is currently in `Cargo.toml` on the checked-out bran
 **QEMU for arm64 Linux**
 Using `ubuntu-latest` (x86_64) to build `aarch64-unknown-linux-gnu` via QEMU inside manylinux is slow and causes container mismatch errors. Use `ubuntu-24.04-arm`.
 
+**Windows arm64 PyPI wheels on hosted runners**
+Maturin needs a matching Python interpreter for wheel generation. On GitHub-hosted Windows runners, the available interpreter reports `win-amd64`, so an `aarch64-pc-windows-msvc` wheel build gets skipped and then fails. Unless you have an arm64 Windows runner with arm64 Python installed, leave Windows arm64 out of the PyPI wheel matrix.
+
 **`yum` vs `apt` in manylinux**
 manylinux2014 is CentOS 7. Use `yum`, not `apt`. For manylinux_2_28 (AlmaLinux 8) use `dnf`.
 

.github/workflows/release-github.yml

@@ -172,7 +172,7 @@ jobs:
           files: release/*
 
       - name: Trigger Homebrew release
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             await github.rest.actions.createWorkflowDispatch({

.github/workflows/release-pypi.yml

@@ -1,5 +1,9 @@
 name: PyPI CLI Release
 
+# Windows arm64 wheels are intentionally not built here. GitHub's hosted
+# Windows runners provide x64 Python, and maturin refuses to build an arm64
+# wheel when the interpreter reports win-amd64.
+
 on:
   workflow_dispatch:
     inputs:
@@ -40,11 +44,7 @@ jobs:
               OS: windows-2022,
               TARGET: x86_64-pc-windows-msvc,
             }
-          - {
-              NAME: win32-arm64-msvc,
-              OS: windows-2022,
-              TARGET: aarch64-pc-windows-msvc,
-            }
+
           - { NAME: darwin-x64, OS: macos-latest, TARGET: x86_64-apple-darwin }
           - {
               NAME: darwin-arm64,

.github/workflows/release-sdk-gem.yml

@@ -1,8 +1,8 @@
 name: SDK Ruby Gem Release
 
 # Publishes the smbcloud-auth Ruby gem (sdk/gems/auth) to RubyGems.
-# Builds pre-compiled native gems for each supported platform, plus a source
-# gem as a fallback for unsupported platforms.
+# Builds pre-compiled native gems for the supported Unix platforms, plus a
+# source gem as a fallback for unsupported environments.
 #
 # Required secrets:
 #   RUBYGEMS_API_KEY — RubyGems.org API key with push access to smbcloud-auth
@@ -64,13 +64,13 @@ jobs:
         shell: bash
         run: |
           for crate_name in smbcloud-auth-sdk smbcloud-model smbcloud-network; do
-            for attempt in 1 2 3 4 5 6; do
+            for attempt in 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20; do
               if curl -fsS "https://crates.io/api/v1/crates/${crate_name}/${RELEASE_VERSION}" >/dev/null 2>&1; then
                 echo "${crate_name} ${RELEASE_VERSION} is available on crates.io"
                 break
               fi
 
-              if [ "$attempt" -eq 6 ]; then
+              if [ "$attempt" -eq 20 ]; then
                 echo "Timed out waiting for ${crate_name} ${RELEASE_VERSION} on crates.io" >&2
                 exit 1
               fi
@@ -145,7 +145,7 @@ jobs:
       - name: Verify gem version matches tag
         shell: bash
         run: |
-          GEM_VERSION=$(sed -n "s/.*VERSION = '\\(.*\\)'/\\1/p" sdk/gems/auth/lib/auth/version.rb)
+          GEM_VERSION=$(sed -n "s/.*VERSION = '\(.*\)'/\1/p" sdk/gems/auth/lib/auth/version.rb)
 
           echo "Gem version : ${GEM_VERSION}"
           echo "Tag version : ${RELEASE_VERSION}"

.github/workflows/release-sdk-pypi.yml

@@ -3,6 +3,10 @@ name: SDK PyPI Release
 # Publishes smbcloud-sdk-auth (sdk/python) to PyPI.
 # Triggered by the crates release workflow when wrapped Rust crates change,
 # or manually via workflow_dispatch.
+#
+# Windows arm64 wheels are intentionally not built here. GitHub's hosted
+# Windows runners provide x64 Python, and maturin refuses to build an arm64
+# wheel when the interpreter reports win-amd64.
 
 on:
   workflow_dispatch:
@@ -44,11 +48,6 @@ jobs:
               OS: windows-2022,
               TARGET: x86_64-pc-windows-msvc,
             }
-          - {
-              NAME: win32-arm64-msvc,
-              OS: windows-2022,
-              TARGET: aarch64-pc-windows-msvc,
-            }
           - {
               NAME: darwin-x64,
               OS: macos-15-intel,

.gitignore

@@ -20,8 +20,8 @@
 /sdk/python/dist/
 /sdk/python/.venv/
 
-# Generated NuGet release artifacts
+# Generated .NET / NuGet build outputs
 /nuget/dist/
-/nuget/smbcloud-cli/bin/
-/nuget/smbcloud-cli/obj/
+/nuget/**/bin/
+/nuget/**/obj/
 /nuget/smbcloud-cli/native/

README.MD

@@ -5,7 +5,7 @@
   <br>smbCloud CLI
 </h1>
   <p align="center">
-    Deploy to the cloud in one command.
+    Deploy with smbCloud from your terminal.
     <br />
     <br />
     <a href="https://smbcloud.xyz/">Website</a>
@@ -22,19 +22,19 @@
     <a href="https://www.nuget.org/packages/SmbCloud.Cli"><img alt="NuGet" src="https://img.shields.io/nuget/v/SmbCloud.Cli"></a>
     <a href="https://github.com/smbcloudXYZ/homebrew-tap"><img alt="Homebrew" src="https://img.shields.io/badge/homebrew-tap-orange?logo=homebrew"></a>
     <a href="https://pypi.org/project/smbcloud-cli/"><img alt="PyPI" src="https://img.shields.io/pypi/v/smbcloud-cli"></a>
-    <a href="https://github.com/smbcloudXYZ/smbcloud-cli/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/smbcloudXYZ/smbcloud-cli"></a>
+    <a href="https://github.com/smbcloudXYZ/smbcloud-cli/blob/main/LICENSE"><img alt="Apache-2.0 License" src="https://img.shields.io/badge/license-Apache%202.0-blue.svg"></a>
   </p>
 </p>
 
 ## About
 
-**`smb`** is the command-line interface for [smbCloud](https://smbcloud.xyz/) — the modern cloud deployment platform. We've eliminated the friction of cloud infrastructure so you can focus on what matters: building an incredible product.
+**`smb`** is the command-line interface for [smbCloud](https://smbcloud.xyz/).
 
-Ship your Rust, Node.js, Ruby, or Swift app with a single, magical command.
+Deploy Rust, Node.js, Ruby, or Swift apps from your terminal.
 
 ## Install
 
-We highly recommend using our **pre-built native binaries** for the fastest, frictionless setup.
+If you want the quickest setup, use a pre-built native binary.
 
 ### Homebrew (macOS & Linux)
 
@@ -83,17 +83,17 @@ smb init
 smb deploy
 ```
 
-That's it. Your app is live.
+That gets you from login to first deploy.
 
 ## Documentation
 
 See the [`docs/`](./docs) directory for guides on authentication, project configuration, and deployment workflows.
 
 ## Contributing
 
-Read [CONTRIBUTING.md](CONTRIBUTING.md) to get started. All contributions are welcome.
+Read [CONTRIBUTING.md](CONTRIBUTING.md) to get started. Contributions are welcome.
 
-> Explore more on the [smbCloud Services](https://smbcloud.xyz/services) page.
+For the broader product, see [smbCloud](https://smbcloud.xyz/) and the [deployment docs](https://smbcloud.xyz/posts).
 
 ## License
 

crates/cli/README.md

@@ -5,7 +5,7 @@
   <br>smbCloud CLI
 </h1>
   <p align="center">
-    Deploy to the cloud in one command.
+    Deploy with smbCloud from your terminal.
     <br />
     <br />
     <a href="https://smbcloud.xyz/">Website</a>
@@ -76,7 +76,9 @@ pip uninstall smbcloud-cli
 smb --help
 ```
 
-## Contribution
+## Contributing
+
+To work on the CLI locally:
 
 - Set up your Rust tooling.
 - Clone the repo.
@@ -89,7 +91,7 @@ This repo draws inspiration from [Sugar](https://github.com/metaplex-foundation/
 
 It also borrows ideas from [the 12 factor CLI app](https://medium.com/@jdxcode/12-factor-cli-apps-dd3c227a0e46).
 
-> Explore more on the [smbCloud Services](https://smbcloud.xyz/services) page.
+More CLI and deployment guides live in the [smbCloud docs](https://smbcloud.xyz/posts).
 
 ## License
 

crates/smbcloud-auth-sdk-py/README.md

@@ -1,8 +1,8 @@
 # smbcloud-auth-sdk-py
 
-PyO3 bindings for the smbCloud Auth SDK.
+PyO3 bindings for smbCloud Auth.
 
-> Explore more on the [smbCloud Services](https://smbcloud.xyz/services) page.
+For higher-level SDK docs, see the [smbCloud developer guides](https://smbcloud.xyz/posts).
 
 ## License
 

crates/smbcloud-auth-sdk-wasm/README.md

@@ -1,10 +1,8 @@
 # smbcloud-auth-sdk-wasm
 
-Wasm bindings for the smbCloud Auth SDK.
+Wasm bindings for smbCloud Auth.
 
-This crate is intended to be published as an npm package via `wasm-pack` and
-consumed by browser clients that need tenant auth-app signup, sign-in, profile
-lookup, and account deletion against the smbCloud Auth service.
+This crate is published as an npm package through `wasm-pack` and used by browser clients that need signup, sign-in, profile lookup, logout, and account deletion against smbCloud Auth.
 
 ## Exports
 
@@ -41,7 +39,7 @@ await signup_with_client(
 );
 ```
 
-> Explore more on the [smbCloud Services](https://smbcloud.xyz/services) page.
+More browser SDK context is available in the [smbCloud docs](https://smbcloud.xyz/posts).
 
 ## License