kutesir/jarvis

Fork 0

Files

Kutesir 457866c7ac

CI / Build · Debug (push) Failing after 10s

Details

CI / Build · Release (push) Failing after 2s

Details

perf: move SwiftData cache and JSON encode off main thread during sync

- cacheStories() runs in Task.detached with a background ModelContext
- persistQuickCache() encodes 100 stories off-thread via Task.detached
- loadSectionSupplements() batches 5 parallel fetches into one sectionSupplement write

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-30 13:14:27 +03:00

2.9 KiB

Raw Blame History

Contributing to Jarvis

Branch workflow

feature/* ──→ develop ──→ main

main — protected. No direct pushes. Every change arrives via PR from develop.
develop — integration branch. All feature work merges here first. CI runs on every push.
feature/* — short-lived branches cut from develop.

Starting work

git checkout develop
git pull origin develop
git checkout -b feature/your-description

Opening a PR

Push your feature branch and open a PR targeting develop.
CI must pass (Debug + Release builds succeed).
At least 1 approval required before merge.

Releasing to TestFlight

A maintainer opens a PR from develop → main. Merging triggers the release workflow: archive → export IPA → upload to TestFlight.

Runner setup (one-time, on your Mac)

Gitea Actions requires a self-hosted runner. The CI workflows target [self-hosted, macos].

1. Enable Gitea Actions (admin, once per instance)

In app.ini on the Gitea server, add:

[actions]
ENABLED = true

Then restart Gitea.

2. Install act_runner on the Mac

brew install act-runner

Or download the binary from your Gitea instance: http://10.10.1.21:3002/-/admin/runners

3. Register the runner

Get a registration token from: Repository Settings → Actions → Runners → Create Runner

Then:

act_runner register \
  --instance http://10.10.1.21:3002 \
  --token <RUNNER_TOKEN> \
  --name "mac-mini" \
  --labels "self-hosted,macos"

4. Start the runner

act_runner daemon

To run it as a background service:

brew services start act-runner   # if installed via brew
# or add a launchd plist manually

The runner must have Xcode 16+ installed and accepted the license:

sudo xcodebuild -license accept

Signing and TestFlight secrets

For the release workflow to archive and upload, the runner Mac needs:

The iOS Distribution certificate installed in its keychain (set up once in Xcode → Settings → Accounts → Manage Certificates).
Three Gitea secrets set under:
Repository Settings → Actions → Secrets

Secret	Where to get it
`ASC_KEY_ID`	App Store Connect → Users & Access → API Keys
`ASC_ISSUER_ID`	Same page, above the key list
`ASC_PRIVATE_KEY`	The `.p8` file downloaded when you created the key (only downloadable once)

Branch protection (manual setup in Gitea UI)

Go to Repository Settings → Branches → Add Branch Rule:

Setting	Value
Branch name pattern	`main`
Require pull request before merging	✅
Required approvals	1
Require status checks to pass	✅ — select `Build · Debug` and `Build · Release`
Block force push	✅
Block deletion	✅

Repeat with develop but set required approvals to 0 (CI gate only).

2.9 KiB Raw Blame History