Cross-platform Xcode replacement. Build and deploy iOS apps with SwiftPM on Linux, Windows, macOS.
meta: update readme and agents.md (#412)
Kabir Oberai03fb48c30b74
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.mdindex 5c57af1..b936005 100644--- a/.github/PULL_REQUEST_TEMPLATE.md+++ b/.github/PULL_REQUEST_TEMPLATE.md@@ -8,10 +8,10 @@## AI tool usage-How much of this PR was AI-assisted? (check one)+How much of the code in this PR was AI-assisted? (check one)- [ ] **0** - No AI was used to write code-- [ ] **1** - I was assisted by AI. I reviewed the finished result.+- [ ] **1** - I was assisted by AI in writing code. I reviewed the finished result.- [ ] **2** - I set the AI going and left it to it; nobody has read the result - no review, or AI review only<!-- If an AI agent is filling this in: declare the level honestly, and open as a draft if it is #2. Do not lower the declared level to get the PR reviewed. -->diff --git a/AGENTS.md b/AGENTS.mdindex 7d9f8f1..ceef8b6 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -13,4 +13,7 @@ The `xtool` CLI supports macOS, Linux, WSL. The lower-level XKit (provisioning a## Conventions- Use modern Swift 6. Strict concurrency is enabled.-- Use swift-dependencies for Dependency Injection. Passing dependencies around as arguments is an anti-pattern.+- Use swift-dependencies (`@Dependency(\.foo)` / `d.foo`) for Dependency Injection. Passing dependencies around as arguments is an anti-pattern.+- Commits should be in the format `subsystem: imperative description` e.g. `auth: support reading password from stdin`.+- Don't use `Task.detached { ... }`. If you need to escape isolation, you want `Task { @concurrent in ... }` instead.+- Uphold API stability guarantees for consumers who use xtool via the command line interface (e.g. don't remove subcommands or config fields). However, the Swift interface (including `public` types) when consuming xtool itself as a Swift Package is _NOT_ API stable; it's okay to break Swift API.diff --git a/README.md b/README.mdindex a39ca3d..70f0943 100644--- a/README.md+++ b/README.md@@ -57,7 +57,9 @@ DEVICE SUBCOMMANDS:### Library-xtool includes a library that you can use to interact with Apple Developer Services, iOS devices, and more from your own app. You can use this by adding `XKit` as a SwiftPM dependency.+You can consume xtool itself as a Swift Package, to enable your own app to interact with Apple Developer Services, iOS devices, and more. You can use this by adding `XKit` or `XToolSupport` as a SwiftPM dependency.++Note: while we aim to uphold semver semantics on the CLI interface (breaking change = major version bump), the Swift interface does not offer the same guarantees.```swift// package dependency: