From e4530c9298fa831af7a95dfdcdf5401a4b2a26b4 Mon Sep 17 00:00:00 2001
From: Tom-Ryder <tom.ryder@live.co.uk>
Date: Wed, 25 Mar 2026 22:54:12 -0700
Subject: [PATCH 1/2] add(repo): ci badge, dependabot, and contributing guide

---
 .github/dependabot.yml | 11 +++++++++
 CONTRIBUTING.md        | 54 ++++++++++++++++++++++++++++++++++++++++++
 README.md              |  1 +
 3 files changed, 66 insertions(+)
 create mode 100644 .github/dependabot.yml
 create mode 100644 CONTRIBUTING.md

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..7d9abee
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: "swift"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..2f8cc0a
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,54 @@
+# Contributing to AgentRunKit
+
+Thanks for your interest in contributing.
+
+## Setup
+
+```bash
+# Install tools
+make bootstrap
+
+# Verify everything works
+make check
+```
+
+`make bootstrap` installs [Mint](https://github.com/yonaskolb/Mint) and the pinned versions of SwiftFormat and SwiftLint from the `Mintfile`.
+
+## Before Submitting a PR
+
+Run the full gate:
+
+```bash
+make check
+```
+
+This runs `swiftformat`, `swiftlint --strict`, and `swift test`. CI runs the same checks — if `make check` passes locally, CI will pass.
+
+## Code Style
+
+- SwiftFormat and SwiftLint enforce the style. Don't fight the tools.
+- No comments or docstrings unless explaining a non-obvious *why*.
+- No backward-compatibility hacks. Prefer the most elegant solution.
+- All public types must be `Sendable`.
+
+See `CLAUDE.md` for the full coding standards.
+
+## Commit Messages
+
+Format: `verb(scope): description`
+
+```
+add(gemini): google gemini client with streaming and tool calling
+fix(auth): prevent token refresh race on concurrent requests
+refactor(api): extract shared validation into middleware
+```
+
+Single sentence, lowercase, imperative mood, no trailing period.
+
+## Tests
+
+Every change needs tests. Test behavior, not implementation details. Run with:
+
+```bash
+swift test --filter YourTestSuite
+```
diff --git a/README.md b/README.md
index 669218c..a18d4ab 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,7 @@
 </p>
 
 <p align="center">
+  <a href="https://github.com/Tom-Ryder/AgentRunKit/actions/workflows/ci.yml"><img src="https://github.com/Tom-Ryder/AgentRunKit/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <img src="https://img.shields.io/badge/Swift-6.0-orange" alt="Swift 6.0">
   <img src="https://img.shields.io/badge/Platforms-iOS%2018%20%7C%20macOS%2015-blue" alt="Platforms">
   <img src="https://img.shields.io/badge/On--Device-MLX%20%7C%20Foundation%20Models-8B5CF6" alt="On-Device MLX + Foundation Models">

From 2e9082eaf08281d1a4017ff1cd1736e39d06b129 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 26 Mar 2026 05:54:50 +0000
Subject: [PATCH 2/2] build(deps): bump actions/cache from 5.0.3 to 5.0.4

Bumps [actions/cache](https://github.com/actions/cache) from 5.0.3 to 5.0.4.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/cdf6c1fa76f9f475f3d7449005a359c84ca0f306...668228422ae6a00e4ad889ee87cd7109ec5666a7)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-version: 5.0.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 0209b92..a88e696 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -24,7 +24,7 @@ jobs:
           persist-credentials: false
       - name: Install Mint
         run: brew install mint
-      - uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
+      - uses: actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
         with:
           path: ~/.mint
           key: mint-${{ hashFiles('Mintfile') }}
@@ -43,7 +43,7 @@ jobs:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           persist-credentials: false
-      - uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
+      - uses: actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
         with:
           path: .build
           key: macos-spm-${{ hashFiles('Package.resolved', 'Package.swift') }}